Status API and webhooks

Payload fields

Every POST has these seven fields, in this order. Use type to tell verification posts from incident updates. Unused fields are empty strings, never omitted.

Verification post

Sent once when you submit a webhook URL. Take the code from message (or title) and enter it on the subscribe page to prove you own the endpoint. The code expires in 15 minutes, and nothing else is sent until you verify.

{
  "title": "StoreConnect Status verification code: A7K2QM",
  "type": "Verification",
  "status": "Pending verification",
  "impact": "",
  "message": "Your StoreConnect Status subscription verification code is A7K2QM. Paste it into https://status.storeconnect.com/subscribe to confirm this webhook. The code expires in 15 minutes.",
  "url": "https://status.storeconnect.com/subscribe",
  "unsubscribeurl": ""
}

Incident update post

Sent whenever we publish an incident or maintenance update with “Notify subscribers” turned on, for incidents that affect a system you subscribed to.

{
  "title": "DNS Latency",
  "type": "Incident",
  "status": "Investigating",
  "impact": "Minor",
  "message": "We're seeing elevated DNS lookup times in ap-southeast-2. Investigating now.",
  "url": "https://status.storeconnect.com/incidents/def456",
  "unsubscribeurl": "https://status.storeconnect.com/subscribe?action=unsubscribe&token=..."
}

Endpoints must be HTTPS. We don't follow redirects, requests time out after 10 seconds, and non-2xx responses are logged but not retried, so keep your endpoint resilient.

Set up a Slack workflow

Post incident updates to a Slack channel in about two minutes with Workflow Builder.

1. In Slack, open Tools → Workflow Builder, select New Workflow, and choose From a webhook as the trigger.
2. Add these seven text variables. The names must match the payload keys exactly:
   • title
   • type
   • status
   • impact
   • message
   • url
   • unsubscribeurl
3. Add a Send a message step. Set the destination channel in the step itself (don't map a variable to it), and use the variables in the message, for example:

   *<{{url}}|{{title}}>*
   {{type}} · {{status}} · {{impact}} impact
   
   {{message}}

4. Publish the workflow and copy its https://hooks.slack.com/triggers/… URL.
5. Paste the URL into the subscribe page under Webhook. We'll post a verification code to the channel; enter it to finish subscribing.

Tip: send updates to a shared channel such as #status-updates rather than a DM so the whole team sees them.

Unsubscribing

Every incident update carries a per-subscriber unsubscribeurl. Open it in a browser to remove the subscription straight away. On verification posts the field is empty because no subscription exists yet.