Send a blast | Surge | Documentation

1 curl -X POST https://api.surge.app/accounts/acct_01j9a43avnfqzbjfch6pygv1td/blasts \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "attachments": [ 6 { 7 "url": "https://example.com/image.jpg" 8 } 9 ], 10 "body": "Join us for our grand opening!", 11 "contacts": [ 12 "ctc_01j9dy8mdzfn3r0e8x1tbdrdrf" 13 ], 14 "name": "Grand Opening Announcement", 15 "segments": [ 16 "seg_01j9dy8mdzfn3r0e8x1tbdrdrf" 17 ], 18 "send_at": "2024-02-01T15:00:00Z" 19 }'

1 { 2 "attachments": [ 3 { 4 "url": "https://example.com/image.jpg" 5 } 6 ], 7 "body": "Join us for our grand opening!", 8 "id": "bst_01j9dy8mdzfn3r0e8x1tbdrdrf", 9 "name": "Grand Opening Announcement", 10 "send_at": "2024-02-01T15:00:00Z" 11 }

Sends a Blast.

Path parameters

account_idstringRequired

The account for which the blast should be sent.

Request

This endpoint expects an object.

attachmentslist of objectsOptional

bodystringOptional

The message body.

contactslist of stringsOptional

List of contact IDs to send the blast to.

namestringOptional

Optional name for the blast.

segmentslist of stringsOptional

List of segment IDs to send the blast to.

send_atstringOptional

When to send the blast. If not provided, sends immediately.

Response

Blast

attachmentslist of objectsOptional

bodystringOptional

The message body.

idstringOptional

Unique identifier for the object.