Create Blast

post

https://public-api.luma.com/v1/events/blasts/create

Email a message to an event's guests now, or at scheduled_for. Blasts go out in the background, count against the calendar's send limit, and can't be recalled once sent. Returns the blast with status: scheduled until it's sent. Limited to 10 blasts per 5 minutes.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

event_id

string

required

Event ID, this usually starts with evt-

recipient_groups

array of objects

length ≥ 1

Who gets the blast. Defaults to going (approved) guests across every ticket type.

recipient_groups

status

string

enum

required

approved means going; checked_in means checked in at the event.

Allowed:

event_ticket_type_id

string | null

Only guests holding a valid ticket of this type. Omit to reach every ticket type. Can't be combined with invited, since invitees hold no tickets.

scheduled_for

date-time

When to send, as an ISO 8601 datetime in the future. Omit to send now.

subject

length ≤ 200

Email subject line. Omit for the default, “New message in {event name}”.

content_md

string

required

length ≥ 1

The message, in markdown. Sent as the email body.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful response.