Sign in
Business Agent

Create a skill

Behavioral instructions in the brand voice. Reads back pending_review until Meta content review passes it. Not idempotent.

post/v1/accounts/{accountId}/business-agent/skills

Path parameters

accountIdstring required

WhatsApp social account id (the number must be managed through the Cloud API).

Request body

titlestring

Lowercase letters, digits and hyphens, e.g. greeting-skill.

descriptionstring

When the agent should apply the skill.

skillstring required

The instructions themselves. Avoid two skills that both claim priority for the same situation.

Response

Skill created

titlestring

Lowercase letters, digits and hyphens, e.g. greeting-skill.

descriptionstring

When the agent should apply the skill.

skillstring required

The instructions themselves. Avoid two skills that both claim priority for the same situation.

idstring required
channelstring
created_atinteger

Unix seconds.

status'active' | 'pending_review' | 'blocked'

pending_review right after a write; blocked means Meta content review rejected it and the agent never applies it.

Changes