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

  1. 01

    Prepare the campaign

    Create the AI Studio template, variables, and campaign.
  2. 02

    Build the Pabbly step

    Send a JSON request to the Pabbly pipeline endpoint.
  3. 03

    Choose the video result

    Use Keep Original by default or Full Script for the Smoothest result.
  4. 04

    Map object keys

    Make each key match an AI Studio variable name exactly and send only its replacement value.
  5. 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.