Skip to content

Tool

add_subscriber

Add subscriber

Idempotent
SurfacesChat agentMCPCLI

Add or update a subscriber in an audience. If the email already exists, updates their info. Use to subscribe new contacts or update existing ones.

CLI: tinbox add-subscriber

Parameters

NameTypeRequiredDescription
audienceIdstringyesThe audience id.
emailstringyesThe subscriber's email address.
namestringnoThe subscriber's name.
statussubscribedpendingtransactionalnoInitial status (default: subscribed, or pending if double opt-in is on).
tagsstring[]noTags to apply to this subscriber.

Example

json
{
  "audienceId": "aud_…",
  "email": "ada@example.com"
}