API and webhooks

API keys

1. In API and webhooks, create a key with a name that identifies it (for example, “Zapier”).
2. Copy it right away: it won't be shown again.
3. Use it in the header Authorization: Bearer <key>. You can revoke it anytime.

What it allows

• List the brand's connected accounts.
• Create immediate, scheduled or draft posts (if the brand requires approvals, they wait for review).
• Read and cancel posts, and get the analytics summary.

Webhooks

Add an https URL and choose the events: published, rejected by the network, approved or changes requested. Each notice arrives signed (X-Shub-Signature header) so you can check it comes from shub.social; if your server fails, we retry up to 6 times.