Overview
When your ConveYour workflow sends an Outbound Webhook to a third-party endpoint, that endpoint can optionally respond with a JSON payload that tells ConveYour to update fields on the contact that triggered the webhook.
This enables lightweight integrations where the external service can “write back” results (IDs, statuses, enrichment values, etc.) without building a custom inbound integration.
How it works (high level)
- Your workflow sends an outbound webhook request to your endpoint.
- Your endpoint returns a normal HTTP response.
- If the response is HTTP 200 and includes a
conveyour block, ConveYour will:
- validate the response operations
- apply the requested updates to the same contact that triggered the webhook
Important notes
- Response operations are opt-in per webhook trigger.
- Updates happen asynchronously (the workflow continues; the write-back may happen moments later).
- Only fields you explicitly allow can be updated.
Enable response operations on a webhook trigger
In the webhook trigger settings:
- Turn on Process response operations.
- Select one or more Allowed fields (the allowlist).
If response operations are enabled but no allowed fields are selected, the trigger cannot be saved.
Response format
Return JSON with a top-level conveyour object: