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

  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

    Map object keys

    Make each key match an AI Studio variable name exactly.
  4. 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.