> ## Documentation Index
> Fetch the complete documentation index at: https://help.kajabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://help.kajabi.com/feedback

```json
{
  "path": "/articles/api-integrations/webhooks/troubleshooting-webhooks",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Troubleshoot webhooks

> Resolve common webhook payload errors and learn best practices for connecting webhooks in Kajabi.

**Webhooks** in Kajabi are URLs that link two apps together, automatically triggering an action in an app after completing an action in another app. For example, adding a contact to InfusionSoft using an Activation Webhook URL for a specific Offer in your Kajabi account will automatically grant the Contact access to that Offer in Kajabi.

<Note>
  **Note:**
  Webhooks on Kajabi are exclusively accessible for Heroes on our Growth or Pro Plans. Learn how to upgrade your Kajabi subscription plan [here](../../account-settings/billing/manage-your-subscription).
</Note>

## Common payload errors

When troubleshooting Kajabi Webhooks, you may encounter the following payload errors:

* **email:** can't be blank
* **name:** can't be blank
* **email:** is invalid

Often, the solution is verifying that both the name and email are included on the Webhook.

It is also good practice to confirm the email is valid.

**Follow this chart to successfully troubleshoot your Webhooks error:**

<img src="https://mintcdn.com/kajabi-support/0-YPsbfqtWW6JQNQ/articles/images/f837bf67_8833983633051.png?fit=max&auto=format&n=0-YPsbfqtWW6JQNQ&q=85&s=846ad13bd87af19c8b7610ee9fbc9391" alt="IMG_2996.jpg" width="2779" height="3695" data-path="articles/images/f837bf67_8833983633051.png" />

## Additional information when troubleshooting webhooks

* Webhooks always require the name, email, and external\_user\_id. All values should be lowercase.
* The external\_user\_id will be prioritized over email.
* The easiest way of making the email and external\_user\_id match is to use the email address as the external\_user\_id. If you need assistance updating your existing users' external\_user\_ids to be the email address, [reach out to Support](../../resources/support/how-to-contact-kajabi-support).
* Make sure the required Key-Value Pair/payload is on the top-level. If it's nested underneath it will not work and will give you the "Email can't be blank and Name can't be blank" error as shown below.

### Sample payload comparing top level payload & nested objects payload

<img src="https://mintcdn.com/kajabi-support/oDd10s3Gsc03FIcd/articles/images/836f87d6_5918890762523.png?fit=max&auto=format&n=oDd10s3Gsc03FIcd&q=85&s=403a1756cfd0fa9021ede2150c1651ef" alt="F8207B11-8012-4F58-BEA6-FBA0D3A1CD72.png" width="506" height="596" data-path="articles/images/836f87d6_5918890762523.png" />
