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",
"generation_mode": "keep_original",
"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.
- generation_mode
- Use keep_original or full_script. Missing or blank values default to keep_original.
- infinitetalk_quality
- Optional for full_script only: standard is 480p at 1x credits; premium is 720p at 2x credits.
- variables
- Object where each key matches an AI Studio variable name and each value contains only the replacement text.
- 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
Choose the video result
Use Keep Original by default or Full Script for the Smoothest result. - 04
Map object keys
Make each key match an AI Studio variable name exactly and send only its replacement value. - 05
Test one trigger
Inspect the generated video result before enabling the full workflow.
Checks
Checks
- Use exact variable names.
- Send only replacement values, without fixed words already present in the template.
- Send generation_mode explicitly even though missing or blank values default to keep_original.
- 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.