Skip to main content

Send burst email configuration

POST https://api.rollstack.com/public/v1/bursts/{id}/email-configs/{configId}/send

Sends a burst's email configuration now: one email to its recipients with each variant it selects. Building it outlasts the request, so it goes out after the answer. Send a test with sendBurstEmailConfigTest first to check how it looks. Only the burst's owner and admins may. Sends have a low rate limit. From an AI client, the send only asks the user to confirm it in Rollstack: it answers confirmation-required and runs once they confirm.

Requires the slide_decks:email scope.

Operation ID: sendBurstEmailConfig.

Path parameters

  • id (string, required): The burst to act on, by its id from listBursts. You can also copy it from the burst's link in Rollstack: it's the part right after /collections/.
  • configId (string, required): The email configuration, by its id from listBurstEmailConfigs.

Headers

  • Idempotency-Key (string): A unique value, such as a UUID, that makes retrying this call safe. A retry with the same key within 24 hours answers the first call's result instead of running it again. Use a new key for each new call. From 1 to 255 printable ASCII characters.

Response 202

Success

application/json

  • id (string, required): The email configuration.
  • name (string or null, required): The email configuration's name.