sendsend.email
Sign inStart building

Save a block for reuse

POST/v1/saved-blocks

Stores one block of a design (a signature, a discount box, a footer) so you can drop it into other templates. A project can keep 100.

Required scope: templates:manage

Request body

FieldType
namerequiredstring
blockrequiredany

Unknown fields are rejected, so a typo never silently does nothing.

Example

curl -X POST 'https://api.sendsend.email/v1/saved-blocks' \
  -H "Authorization: Bearer $SENDSEND_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Support signature",
  "block": {
    "type": "signature",
    "name": "Sam",
    "title": "Support"
  }
}'

Response 201

{
  "id": "blk_4Tq…",
  "object": "saved_block",
  "name": "Support signature",
  "block": {
    "type": "signature",
    "name": "Sam",
    "title": "Support"
  },
  "created_at": "2026-10-15T09:00:00.000Z"
}

Errors

StatusCodeWhen
400validation_errorThe request body or parameters are invalid. The message says which field.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.