Configure an Incoming Webhook in Copilot

This article explains how to set up an incoming webhook inside TexAu Copilot so that external tools can send data directly into a Copilot workflow.

What an incoming webhook does in Copilot

An incoming webhook gives you a unique URL. When an external tool sends a POST request to that URL, Copilot receives the payload and can act on it. For example, it can add rows to a table, trigger an enrichment run, or start a workflow.

Use this when you want to connect Zapier, Make, your own app, or any other tool to a Copilot workflow.

Before you begin

You need a Copilot workflow set up. If you do not have one yet, see Build a Workflow with Copilot.

Generate the webhook URL

1. Open the Copilot workflow you want to connect to.
2. Click the Webhooks icon in the Copilot toolbar, or type "Set up an incoming webhook" in the chat.
3. The incoming webhook configuration form opens.
4. Click Generate webhook URL.
5. Copy the URL that appears. You will paste this into your external tool.

Configure the payload mapping

After generating the URL, you need to tell TexAu what fields to expect in the incoming payload and where to put them.

Send a test payload

1. Go to your external tool (Zapier, Make, a REST client, etc.).
2. Send a POST request to the webhook URL with a sample JSON body. For example:

{
  "firstName": "Jane",
  "lastName": "Smith",
  "linkedinUrl": "https://linkedin.com/in/janesmith",
  "company": "Acme Corp"
}

3. Return to the Copilot incoming webhook form. The sample payload appears automatically.

Map fields to columns

1. In the Field mapping section, each key from the payload appears as a row.
2. For each field, select which table column should receive the value.
3. If you want a field to create a new column, select Create new column from the dropdown.
4. Click Save mapping.

Authenticate inbound requests (optional)

To verify that requests to your webhook come from a trusted source:

1. In the webhook form, click Show authentication options.
2. Enable Signature verification.
3. Copy the secret key.
4. Configure your external tool to sign requests with this key.

TexAu rejects requests that do not include a valid signature.

Test the webhook

1. Click Test webhook in the configuration form.
2. TexAu sends a test signal and confirms the connection is working.
3. A success message appears when the webhook is active.

Troubleshooting

The webhook URL returns a 404 error. The webhook was not saved. Complete the configuration and click Save before testing.

Payloads are arriving but rows are not being created. Check the field mapping. At least one field must be mapped to a column for rows to appear. If no fields are mapped, the payload is received but ignored.

The signature verification is failing. The secret key in your external tool does not match the key in TexAu. Copy the key again from the webhook form and update it in your external tool.

The webhook receives data but the wrong column is being populated. Open the field mapping section and verify each payload key maps to the correct column.