webhooks

webhooks.configure_enrichment

Configure Webhook Enrichment

Effects: write

Enable enrichment on an agent's webhook trigger so reference-only webhook payloads are resolved to full data before the agent runs. One tool for every provider — choose provider and pass its config.

Providers & required config:

• meta_leadgen (Meta/Facebook Lead Ads): config = {app_id, app_secret, user_access_token}. The user token needs pages_show_list + leads_retrieval (+ pages_manage_metadata; add business_management to auto-discover Business-Manager pages that /me/accounts omits). Stores all page tokens encrypted per workspace and resolves each lead's name/email/phone. Reuses the existing webhook URL (no token rotation); creates a webhook trigger if the agent has none.

Arguments

Argument	Type	Required	Description
agent_id	integer	yes	ID of the agent whose webhook trigger should be enriched.
config	object	yes	Provider-specific configuration/credentials. For meta_leadgen: {app_id, app_secret, user_access_token}.
provider	string	yes	Enrichment provider to configure. (one of meta_leadgen)