Send a broadcast
Changed onSends one message to many participants on a study. Each of them gets a new conversation carrying the broadcast's subject, topic and study, with the message as its first message. Replies stay in that conversation, between the participant and the sender.
The broadcast is saved as it was sent and never changes. The conversations are created in the background, so they can take a short while to appear.
Pass your own id to make sending safe to repeat. Sending again with an id you've already used returns that broadcast rather than sending it twice.
Send it to recipient_ids or to a participant_group_id, exactly one of the two. With audience_source: submissions, each recipient must have a submission for the study in any status. With audience_source: TYPED_IDS (IDs typed in) or MESSAGES (participants picked from your conversations), each must be a participant who has taken part in one of your studies or already has a conversation with you. A group's members get it as the group is at the moment of sending, whether or not they're on the study, which only labels the broadcast. Each member must have taken part in one of your studies or already have a conversation with you. A group that isn't in the study's workspace or its organisation, or that you can't view, returns 404, and one with no members returns 400. If your access to the group can't be checked right now, it returns 503. A broadcast has the same recipient limit as a bulk message. Going over it returns a 400 that gives the limit. The study must belong to a workspace you are in. A study you can't broadcast about returns 404, as does the endpoint while broadcasts aren't enabled for the study's workspace.
Request
- Base URLhttps://api.prolific.com
- URLhttps://api.prolific.com/api/v1/broadcasts/
- AuthAPI key in header Authorization
Request body
Response
The broadcast
Changes
- warning
added the new
MESSAGESenum value to theresponse property for the response status - info
added the new
MESSAGESenum value to the request property
- warning
- warning
added the new
TYPED_IDSenum value to theresponse property for the response status - info
added the new
TYPED_IDSenum value to the request property
- warning