Developers
Trigger BHuman with object-style webhook payloads.
Use Pabbly when the workflow builder sends named variable fields instead of ordered arrays.
Use case
When to use Pabbly
Pabbly-style generation is useful when a webhook builder can send a JSON object keyed by variable name. It is simpler than ordered arrays when there is one generated video per trigger.
Payload
Payload shape
Pabbly payload
JSON{
"campaign_id": "YOUR_CAMPAIGN_ID",
"variables": {
"first_name": "Alex",
"company": "ExampleCo",
"cta_url": "https://example.com/start"
},
"callback_url": "https://yourapp.com/bhuman/callback"
}- campaign_id
- The AI Studio campaign to generate from.
- variables
- Object where each key matches an AI Studio variable name.
- callback_url
- Optional HTTPS URL for completion details.
Setup
Setup flow
- 01
Prepare the campaign
Create the AI Studio template, variables, and campaign. - 02
Build the Pabbly step
Send a JSON request to the Pabbly pipeline endpoint. - 03
Map object keys
Make each key match an AI Studio variable name exactly. - 04
Test one trigger
Inspect the generated video result before enabling the full workflow.
Checks
Checks
- Use exact variable names.
- Send HTTPS URLs for CTA and callback fields.
- Do not send blank values for required variables.
- Use callbacks or polling to collect generated assets after render completion.
Use the API guide for endpoint details
Swagger remains the endpoint-level source for the latest schema and optional fields.