Webhooks Integration

What Are Webhooks?

Webhooks allow IDEQO to send your content to any custom endpoint via HTTP POST requests. This universal integration lets you connect to platforms that don’t have native IDEQO integrations, custom applications, or your own systems.

Use cases:

• Connect to platforms without native integrations
• Send content to custom applications or databases
• Integrate with internal tools and workflows
• Build custom automation workflows

Setting Up a Webhook Integration

1. 1
   Go to Integrations

   Navigate to Settings > Integrations and click Connect Webhook.

2. 2
   Enter Webhook Details

   Provide a name for your integration and the destination URL.

3. 3
   Optional Security

   Add a Webhook Secret in Advanced Settings to sign requests with HMAC for security.

4. 4
   Test Connection

   Click Test to send a sample payload to your endpoint.

5. 5
   Save Integration

   Enable the integration and save to start receiving content updates.

Webhook Payload Format

When content is published, IDEQO sends a POST request to your webhook URL with the following JSON structure:

{
  "event": "content.scheduled",
  "content_id": "c-12345-uuid",
  "content_type": "social_post",
  "content": {
    "id": "c-12345-uuid",
    "content": "This is the post content...",
    "status": "published",
    "created_at": "2025-01-27T10:00:00Z"
  },
  "media": [
    {
      "id": "m-123",
      "url": "https://storage.ideqo.com/image.jpg",
      "type": "image"
    }
  ],
  "scheduled_at": "2025-01-27T10:00:00Z",
  "user": {
    "id": "u-123",
    "timezone": "UTC"
  }
}

Security Headers

If you configure a Webhook Secret, IDEQO includes these headers for verification:

• X-IDEQO-Signature: HMAC SHA-256 signature of the payload
• X-IDEQO-Event: Event type (e.g., content.scheduled)
• X-IDEQO-Timestamp: Time of the request