Developers
API keys and webhooks so SocialWise fits into your own systems.
For discussionWhich plans get API access and webhooks: all plans, or Pro and up? Keys are limited to 120 requests a minute each.
Make a key
What can this key do?"all" is today's full access, used by the Claude connector. A key gets 403 outside its scopes.
Keys
| Name | Scopes | Key | Last used | |
|---|---|---|---|---|
| Claude connector | all | swk_…9f2a | 4 min ago | |
| Zoho sync | leads:read | swk_…41c0 | 1 h ago | |
| Website order form | leads:write media:write | swk_…7d18 | Yesterday |
Add an endpoint
Events
Endpoints
https://erp.themuralstory.com/hooks/socialwise
lead.created, lead.updated · last success 3 min agowhsec_••••••••3kQ
lead.created, lead.updated · last success 3 min agowhsec_••••••••3kQ
https://hooks.zapier.com/hooks/catch/18…
post.published, reel.ready · failing since 09:12Failing
post.published, reel.ready · failing since 09:12Failing
Last 50 deliveries
retries back off: 1 min, 5 min, 30 min, 2 h, 6 h| Time | Event | Endpoint | Response | Try | Status |
|---|---|---|---|---|---|
| 10:41 | lead.created | erp.themuralstory.com | 200 | 1 | ✓ Delivered |
| 10:17 | lead.updated | erp.themuralstory.com | 200 | 1 | ✓ Delivered |
| 09:58 | reel.ready | hooks.zapier.com | 502 | 3 | Retrying 10:28 |
| 09:12 | post.published | hooks.zapier.com | timeout | 5 | ✕ Failed |
Your first call
Base URL https://api.socialwise.app/v1. Full reference at /v1/docs. Everything under /v1 stays stable.
curl https://api.socialwise.app/v1/leads?stage=qualified \
-H "Authorization: Bearer swk_live_…41c0"
{"data": [{"id": "ld_8f2c", "name": "Priya Mehta",
"stage": "qualified", "value": 42000, ...}],
"next_cursor": "eyJpZCI6Imxk..."}
Errors always look like {"error": {"code", "message"}}. Past 120 calls a minute you get 429 with Retry-After.
Check a webhook signature
// Node
const sig = req.headers['x-socialwise-signature'];
const ts = req.headers['x-socialwise-timestamp'];
const want = crypto.createHmac('sha256', SECRET)
.update(ts + '.' + rawBody).digest('hex');
if (sig !== want) return res.status(401).end();
// x-socialwise-delivery is the dedupe id
The getting-started page on the docs site has curl, Python and Node versions.
What /v1 covers
| Area | Routes | Scopes |
|---|---|---|
| Leads | list, get, create, update stage / owner / tags / value, add note | leads:read, leads:write |
| Conversations | list conversations, list messages, send a reply | inbox:read, inbox:write |
| Posts | list, draft from text + media URLs, schedule, cancel | posts:read, posts:write |
| Media | upload from URL | media:write |
| Analytics | post results for a range | analytics:read |
| Products | list, create, update | posts:write |