---
title: "Create or update reusable blocks"
method: POST
path: "/notifications/reusable-blocks/import"
tags: ["Notifications"]
---

# Create or update reusable blocks

`POST /notifications/reusable-blocks/import`

Creates reusable blocks if you do not specify block IDs, or updates existing reusable blocks if you specify valid block IDs. All fields must be provided for each reusable block you want to update.

The maximum number of reusable blocks that you can create or update by one call is 1,000.

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string

## Request body

- CreateOrUpdateReusableBlockRequest
  - `allowPartialSuccess` boolean — When set to false, the call will fail if one or multiple instances fail to import, and a 200 response is returned if all reusable blocks have been successfully updated. When set to true, a success (200) response is returned if one or more instances have imported successfully. All failed instances are also returned in the response.
  - `reusableBlocks` CreateOrUpdateReusableBlockFormat[] — A container for reusable blocks.
    - `active` boolean — The status of the reusable block. Only active blocks can be embedded into email templates.
    - `category` 'Headers' | 'Footers' | 'Other', required — The category of the reusable block. You can filter blocks by category when editing email templates in the UI.
    - `content` string, required — The content of the reusable block, which is automatically inserted into email templates when sending email notifications.
    - `id` string — ID of an existing reusable block. Specify this field if you want to update an existing reusable block. You must provide all fields when updating an existing reusable block.
    - `name` string, required — The name of the reusable block. The value must be unique across all blocks.
    - `number` string — The number of the reusable block. The value must be unique across all blocks. If not specified, a unique value will be provided by default.
    - `tags` string[] — List of tags that help you quickly locate reusable blocks when editing email templates in the UI by using the tag filter.

## Response `200`

OK

- CreateOrUpdateReusableBlockResponse
  - `reasons` string[] — Returns an empty array if the request succeeds.

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)