latestOpenAPI 3.1.02026-08-1014497184.0 KB

8b99dca11019

Fetch a broadcast

Retrieves detailed information about a specific broadcast by its ID. Includes the broadcast's configuration and current status.

get/broadcasts/{broadcast_id}

Path parameters

broadcast_idstring required

Response

OK

action_urlstring nullable

The URL recipients will be directed to when interacting with the broadcast.

categorystring nullable

The label used to group broadcasts.

contentstring nullable

The body content delivered with the broadcast.

created_atstring date-time

The timestamp when the broadcast was created.

custom_attributesobject nullable

Arbitrary custom data associated with the broadcast.

idstring uuid

The unique id for this broadcast.

titlestring required

The subject or headline that will be shown to recipients.

topicstring nullable

The topic that further classifies the broadcast.

Example response

{
  "action_url": "https://example.com",
  "category": "example",
  "content": "I come from broadcast",
  "custom_attributes": {},
  "id": "d1b3b3b3-3b3b-3b3b-3b3b-3b3b3b3b3b3b",
  "overrides": {},
  "recipients": [
    {
      "custom_attributes": {
        "plan": "enterprise",
        "preferred_pronoun": "They",
        "pricing_version": "v10"
      },
      "email": "test@example.com",
      "external_id": "83d987a-83fd034",
      "first_name": "Person",
      "last_name": "Doe",
      "phone_numbers": [
        "+1 5005550001"
      ]
    }
  ],
  "title": "Hello, World!",
  "topic": "example"
}