> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Default Email Component

> Create or replace the company's default component for a slot, such as the email footer.

# Set Default Email Component

You can change the footer every new email gets by writing the company's default `footer` component. Sequence, campaign, and AI-generated emails clone this component when they are built, instead of the footer Sequenzy generates from your company profile.

This replaces the whole component. Read the current one with [Get Default Email Component](/api-reference/email-components/get-default) first when you only mean to change part of it.

<Note>
  A default footer always keeps its unsubscribe link enabled. Transactional
  sends hide it at render time. Changing the default does not rewrite emails
  that already exist - they keep the footer they were built with.
</Note>

## Request

<ParamField path="slot" type="string" required>
  Default slot to write. Currently only `footer`.
</ParamField>

<ParamField body="blocks" type="array" required>
  Blocks that make up the component. Must contain at least one block. Put block
  styling under `styles`; top-level style keys are normalized into `styles`.
</ParamField>

<ParamField body="name" type="string">
  Component name. Defaults to `Default Footer` when creating the footer
  default. Names are unique per company.
</ParamField>

<ParamField body="description" type="string">
  Optional human-readable description.
</ParamField>

```bash theme={null}
curl -X PUT "https://api.sequenzy.com/api/v1/email-components/defaults/footer" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"blocks":[{"type":"footer","variant":"full","companyName":"Acme"}]}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "component": {
      "id": "cmp_123",
      "companyId": "comp_123",
      "name": "Default Footer",
      "description": null,
      "blocks": [
        {
          "id": "block_1",
          "type": "footer",
          "variant": "full",
          "companyName": "Acme",
          "showUnsubscribe": true
        }
      ],
      "componentType": "footer",
      "defaultSlot": "footer",
      "version": 4,
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-08-12T11:00:00.000Z"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "emailComponents.saveDefault: invalid block at 0: Unknown block type"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Invalid API key"
  }
  ```

  ```json 409 theme={null}
  {
    "success": false,
    "error": "A component with this name already exists"
  }
  ```
</ResponseExample>

## Related

* [Get Default Email Component](/api-reference/email-components/get-default)
* [Update Email Component](/api-reference/email-components/update)