Skip to content
Docs

Assign Warmup Tag

Put a tag on an email account.

POST/api/v1/warmup/pool/{account_id}/tags/{tag_id}

Requires an API key with the write scope.

Warmup tags group accounts in the warmup pool. They do not change sending. Repeating the call is safe: a tag already on the account stays as it is.

Path Parameters#

account_idstringpathrequired
The email account id.
tag_idstringpathrequired
The tag id.

Response#

dataobject
Show data
accountIdstring
The email account.
tagIdstring
The tag.
assignedboolean
true.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: write
404Account not found: the account does not exist in this workspace
404Tag not found: the tag does not exist in this workspace

Rate Limit#

  • 120 requests per minute, shared by every write call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (write).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026