Update flow metadata

Update flow name, categories, endpoint_uri, or application_id.

Include at least one nonblank query parameter: phone_number_id or business_account_id. Kapso uses this context to select the connection and authorize access.

Send JSON or multipart form data. In form data, send categories as a JSON-encoded array string.

Rename a draft flow:

curl -X POST "https://api.kapso.ai/meta/whatsapp/v24.0/FLOW_ID?phone_number_id=PHONE_NUMBER_ID" \
  -H "X-API-Key: YOUR_PROJECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Updated Flow Name"}'

Proxy endpoint: Proxies directly to Meta Graph API.

POST /{flow_id}

Update flow metadata

cURL

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{flow_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "Updated Flow Name",
  "categories": [
    "APPOINTMENT_BOOKING",
    "CUSTOMER_SUPPORT"
  ]
}
'

200

{
  "success": true
}

Authorizations

ApiKeyAuthBearerAuth

X-API-Key · string · header · required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Integrations > API keys.

Path Parameters

flow_id · string · required

Flow ID

Query Parameters

phone_number_id · string

Required when updating flow by ID (unless business_account_id provided)

business_account_id · string

Required when updating flow by ID (unless phone_number_id provided)

Body

application/jsonmultipart/form-data

name · string

Flow name

categories · enum<string>[]

Flow categories (at least one required if provided)

Available options: SIGN_UP, SIGN_IN, APPOINTMENT_BOOKING, LEAD_GENERATION, CONTACT_US, CUSTOMER_SUPPORT, SURVEY, OTHER

endpoint_uri · string<uri>

URL of the WhatsApp Flow Endpoint (for Flow JSON 3.0+)

application_id · string

ID of the Meta application connected to the Flow

Response

200

application/json

Flow metadata updated successfully

success · boolean