Webhook Integrations & API Usage

Webhooks allow Audenci to send real-time notifications to your external systems when events occur. Use cases: Notify Slack when post publishes, Update CRM when campaign completes, Trigger custom workflows, Sync data to data warehouse, Send SMS alerts for critical events.

• post.created - New post created
• post.published - Post went live on platforms
• post.failed - Publishing failed
• post.status_changed - Status transition occurred
• campaign.started - Campaign start date reached
• campaign.ended - Campaign end date passed
• analytics.updated - Post analytics refreshed
• follower.milestone - Follower count milestone reached
• comment.received - New comment on your post (coming soon)
• mention.detected - Brand mentioned on social media (coming soon)

To create a webhook: Go to Settings → Integrations → Webhooks, Click 'Create Webhook', Enter webhook URL (https://your-domain.com/webhook), Select events to trigger, Add custom headers (optional, for authentication), Test webhook, Enable webhook.

Webhook payloads include: Event type (e.g., 'post.published'), Timestamp (ISO 8601 format), Object data (post, campaign, etc.), Organization ID, Brand ID, User ID (who triggered the event). Example POST body:

{
  "event": "post.published",
  "timestamp": "2026-02-03T10:30:00Z",
  "data": {
    "postId": "clx123abc",
    "title": "Summer Sale Announcement",
    "platforms": ["instagram", "facebook"],
    "scheduledFor": "2026-02-03T10:00:00Z",
    "platformResults": {
      "instagram": { "success": true, "postId": "123456789" }
    }
  },
  "organizationId": "clx789xyz",
  "brandId": "clx456def"
}

Secure your webhooks with authentication: Signature verification (HMAC-SHA256 of payload), Custom headers (Authorization: Bearer token), IP whitelisting (restrict to Audenci IPs), HTTPS only (encrypted transport). Audenci sends X-Audenci-Signature header with HMAC signature. Verify the signature to ensure request came from Audenci.

Test webhooks before going live: Use webhook testing tools (webhook.site, RequestBin), Trigger test events manually, Check webhook logs for delivery status, Verify payload format, Test error handling (what if your endpoint is down?). Audenci retries failed webhooks with exponential backoff.

Audenci REST API allows programmatic access to all features: Create, read, update, delete posts, Manage campaigns and content plans, Upload media, Fetch analytics, Manage social accounts, Trigger AI generation. API base URL: https://app.audenci.com/api

Authenticate API requests with API keys: Generate API key in Settings → API Keys, Include in requests: Authorization: Bearer YOUR_API_KEY, Keys can be scoped to specific permissions (read-only, read-write), Rotate keys regularly for security, Revoke compromised keys immediately.

Key API endpoints:

• GET /api/posts - List posts with filters
• POST /api/posts - Create new post
• GET /api/posts/{id} - Get post details
• PUT /api/posts/{id} - Update post
• DELETE /api/posts/{id} - Delete post
• POST /api/posts/{id}/publish - Publish post
• GET /api/analytics - Fetch analytics data
• POST /api/images/generate - Generate AI images
• POST /api/plans/generate-preview - Create content plan
• GET /api/social/accounts - List connected accounts

API requests are rate limited by plan: Starter: 100 requests/hour, Growth: 500 requests/hour, Scale: 2,000 requests/hour, Enterprise: 10,000+ requests/hour. Rate limit headers returned: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Implement exponential backoff when rate limited (429 status).

API returns standard HTTP status codes: 200 OK (success), 201 Created (resource created), 400 Bad Request (invalid input), 401 Unauthorized (invalid API key), 403 Forbidden (insufficient permissions), 404 Not Found (resource doesn't exist), 429 Too Many Requests (rate limited), 500 Internal Server Error (server issue). Error responses include: error code, error message, and details.

• Sync published posts to CRM for sales team visibility
• Trigger Zapier workflows when campaigns complete
• Send Slack notifications for failed posts
• Update data warehouse with analytics daily
• Build custom dashboard with API data
• Automate post creation from external systems
• Integrate with project management tools (Asana, Jira)
• Create custom mobile apps using API