GoodInboxes Developers
API reference

Assign a tag to owned inboxes

POST
/api/v1/sequencers/{provider}/tags/assign

Read a bounded provider tag window. Writes require a separate operator flag and explicit scope.

Separately gated. A 200 response is not completion; verify every item and partial=false.

Required scope: sequencer:tags:write.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Scoped GoodInboxes API token

Path Parameters

provider*string

emailbison or smartlead.

Request Body

application/json
  1. body
inboxIds*array<string>

1–10 distinct owned paid/released inbox UUIDs.

Items1 <= items <= 10
tagId*string

Decimal string for a positive safe-integer provider tag ID.

requestId*string

Stable operation UUID for retries.

consent*boolean

Explicit true after the customer approves the exact targets and tag.

Response Body

data.results[] with per-inbox status and data.partial

application/json
  1. response
data*

data.results[] with per-inbox status and data.partial

requestId?string
curl -X POST "https://example.com/api/v1/sequencers/string/tags/assign" \  -H "Content-Type: application/json" \  -d '{    "inboxIds": [      "string"    ],    "tagId": "string",    "requestId": "string",    "consent": true  }'
{  "data": {},  "requestId": "string"}