Sign in
Events

Fan out an event

This endpoint uses the owner_id to fan out an event to multiple endpoints. The 201 body includes uid (the event id). Use GET /events/{eventID} or GET /eventdeliveries?eventId= to follow the send.

post/v1/projects/{projectID}/events/fanout

Path parameters

projectIDstring required

Project ID

Request body

custom_headersobject nullable

Specifies custom headers you want convoy to add when the event is dispatched to your endpoint

dataobject nullable

Data is an arbitrary JSON value that gets sent as the body of the webhook to the endpoints

event_typestring

Event Type is used for filtering and debugging e.g invoice.paid

idempotency_keystring

Specify a key for event deduplication

owner_idstring

Used for fanout, sends this event to all endpoints with this OwnerID.

Response

Created

messagestring
statusboolean

Changes