Outbound Webhooks Guide

Overview

Outbound webhooks allow MojaAI to send real-time notifications to your systems when call events occur. Configure webhook endpoints to receive instant updates about calls and conversions. For sending data to MojaAI (caller metadata, revenue updates, tags), see the Inbound Webhooks Guide.

What you can do with webhooks:

• Receive instant call event notifications
• Update your CRM in real-time
• Track conversions and revenue automatically
• Trigger workflows based on call duration milestones

Setting Up Webhooks

1. Navigate to Webhooks > Outgoing in your MojaAI dashboard
2. Click Create Webhook
3. Enter your endpoint URL
4. Select the event type you want to trigger on
5. Define your request template (URL, headers, body) using [TAG_NAME] placeholders
6. Choose body format (JSON or form data)
7. Save the webhook

Sample Event Types

The following are common event types. For a complete and up-to-date list, see Webhooks > Outgoing in your MojaAI dashboard.

New event types may be added as the platform evolves. Always refer to your dashboard for the current list of available events.

Webhook Payload

Outbound webhooks are fully configurable. When creating a webhook, you define your own request template — including the URL, HTTP method, headers, and body. MojaAI replaces [TAG_NAME] placeholders in your template with actual call data at dispatch time.

How It Works

1. Create a webhook configuration in Webhooks > Outgoing
2. Select an event type to trigger on
3. Define your URL, headers, and body using [TAG_NAME] placeholders
4. When the event fires, MojaAI replaces all placeholders with real values and sends the request

Supported Formats

• JSON — Request body sent as application/json
• Form Data — Request body sent as application/x-www-form-urlencoded

HTTP Methods

Webhooks support: GET, POST, PUT, PATCH, DELETE

Example Template

Body template (configured in dashboard):

{
  "call_id": "[CALL_ID]",
  "caller": "[CALLER_ID]",
  "campaign": "[CAMPAIGN_NAME]",
  "duration": "[DURATION]",
  "converted": "[CONVERTED]",
  "revenue": "[REVENUE_PAID_OUT]",
  "tags": {
    "source": "[UTM_SOURCE]",
    "state": "[CALLER_STATE]"
  }
}

Resulting payload (after placeholder replacement):

{
  "call_id": "call_abc123def456",
  "caller": "+13105559876",
  "campaign": "Medicare Leads Q1",
  "duration": "145",
  "converted": "true",
  "revenue": "35.00",
  "tags": {
    "source": "google_ads",
    "state": "CA"
  }
}

Placeholders can also be used in the URL and query parameters. For example: https://your-api.com/webhook?call_id=[CALL_ID]&campaign=[CAMPAIGN_ID]

Sample Tags

The tags below are commonly used placeholders. For a complete and up-to-date list of available tags, see Webhooks > Outgoing in your MojaAI dashboard when creating or editing a webhook.

Use these [TAG_NAME] placeholders in your webhook URL, headers, query parameters, and body.

Call Identification

Campaign & Publisher

Target & Buyer

Conversion & Revenue

Landing Page & Attribution

These tags are populated for calls originating from Dynamic Number Insertion (DNI):

Custom Tags

Any custom tags you define are also available as placeholders using their tag key in uppercase. For example, if you create a custom tag with key lead_type, use [LEAD_TYPE] in your template.

Failed webhook deliveries are logged and visible in Webhooks > Outgoing Webhook Requests in your dashboard.

Best Practices

1. Use HTTPS - All webhook endpoints should use HTTPS
2. Handle duplicates - Use [CALL_ID] to deduplicate if needed
3. Log payloads - Store raw payloads for debugging
4. Monitor deliveries - Check Webhooks > Outgoing Webhook Requests for failed deliveries

Testing Webhooks

Use the Test Webhook button in your dashboard to send a sample payload to your endpoint. This helps verify your integration before going live.

Custom Headers

Add custom headers to authenticate requests to your endpoint:

{
  "Authorization": "Bearer your-api-token",
  "X-Custom-Header": "custom-value"
}

Configure these in the webhook settings in your dashboard.

Troubleshooting

Problem: Webhooks aren't being received

• Solution: Verify your endpoint URL is correct and accessible. Check that your server isn't blocking requests from MojaAI IP addresses. Review delivery status in Webhooks > Outgoing Webhook Requests.

Problem: Placeholder tags not being replaced

• Solution: Ensure tag names in your template are uppercase and wrapped in brackets, e.g. [CALL_ID]. Note that not all tags are available on every event type — for example, conversion-related tags like [CONVERTED] and [REVENUE_PAID_OUT] are not populated on early events such as call.incoming. If a tag is not available for the event that fired, the raw placeholder text (e.g. [CONVERTED]) is returned in the payload instead of a value. Check the event type documentation in your dashboard to confirm which tags are available for each event.

Problem: Webhooks are timing out

• Solution: Return 200 OK immediately and process the webhook asynchronously. Your endpoint must respond within 10 seconds.

Need Help?

• Email: [email protected]
• Help Center: Available in your MojaAI dashboard
• Related: Inbound Webhooks Guide · API Reference