Mavrck Workflow Stage Change Event Webhook

The one outbound event Mavrck (Later Influence) emits: an HTTPS POST to a subscriber-registered URL whenever an influencer is added to one of the subscriber's campaigns or moves between that campaign's workflow stages. Published by the provider as an OpenAPI 3.0.0 contract on SwaggerHub under owner `mavrck`; authorization is a static 16-character token carried in the notification body, with no signature header.

OpenAPI Specification

mavrck-workflow-stage-change-event-webhook-openapi.json Raw ↑
{"openapi":"3.0.0","info":{"title":"Workflow Stage Change Event Webhook","version":"1.0.0"},"servers":[{"url":"https://www.example.com"}],"tags":[{"name":"Path"}],"paths":{"/example-path":{"post":{"description":"Notifies a subscriber when influencers are added to one of their campaigns or moved from one of their campaign’s workflow stages to another.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStageChangeNotification"}}},"required":true},"responses":{"200":{"description":"Mavrck successfully delivered the event to Subscriber."},"401":{"description":"Subscriber rejected Mavrck’s request because it isn't authorized. Mavrck will not retry."},"403":{"description":"Subscriber rejected Mavrck’s request because access to a particular resource is forbidden. Mavrck will not retry."},"404":{"description":"Subscriber rejected Mavrck's request because a particular resource could not be found. Mavrck will not retry."},"405":{"description":"Subscriber rejected Mavrck's request because the request method is not known. Mavrck will not retry."},"500":{"description":"Mavrck failed to deliver the event to Subscriber and will retry."},"502":{"description":"Mavrck failed to deliver the event to Subscriber and will retry."}},"tags":["Path"]}}},"components":{"schemas":{"Campaign":{"type":"object","description":"Details of the campaign in which the workflow stage change occurred.","properties":{"id":{"type":"integer","description":"Unique ID of the campaign in which the workflow stage change occurred."},"instanceId":{"type":"integer","description":"Unique ID of the instance to which the campaign belongs."}}},"Influencer":{"type":"object","description":"Details of the influencer whose workflow stage changed.","properties":{"id":{"type":"integer","description":"Unique ID of the influencer whose workflow stage changed."},"membershipId":{"type":"integer","nullable":true,"description":"Unique ID of the relationship between the influencer and your instance."}}},"WorkflowStage":{"type":"object","description":"Details of a point in a campaign denoting an influencer's progress towards campaign completion.","properties":{"label":{"type":"string","description":"Unique, mutable ID of a workflow stage."},"slug":{"type":"string","description":"Unique, immutable ID of a workflow stage in a campaign."}}},"WorkflowStageChangeEvent":{"type":"object","description":"Details of the workflow stage change.","properties":{"campaign":{"$ref":"#/components/schemas/Campaign"},"current":{"$ref":"#/components/schemas/WorkflowStage"},"influencer":{"$ref":"#/components/schemas/Influencer"},"previous":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/WorkflowStage"}]}}},"WorkflowStageChangeNotification":{"type":"object","properties":{"event":{"$ref":"#/components/schemas/WorkflowStageChangeEvent"},"subscriberId":{"type":"string","description":"Unique ID of your webhook. If your application’s HTTP(S) POST endpoint receives multiple instances’ workflow stage change events, or if multiple applications receive the same instance's events, then this value will vary."},"token":{"type":"string","description":"A 16-character alphanumeric string used to authorize requests to your application. Your subscriber's token is accessible in the platform."}}}}}}