Actions119
- Call (Beta) Actions
- Chat Actions
- Community Actions
- Group Actions
- Group (More) Actions
- Instance Actions
- Instance (More) Actions
- Message Actions
- Message (More) Actions
- Newsletter / Channel Actions
- Accept Admin Invite
- Create Newsletter
- Delete Newsletter
- Follow Newsletter
- Get Newsletter Metadata
- List Newsletters
- Mute Newsletter
- Remove Newsletter Admin
- Revoke Admin Invite
- Search Newsletters
- Transfer Newsletter Ownership
- Unfollow Newsletter
- Unmute Newsletter
- Update Newsletter Description
- Update Newsletter Name
- Update Newsletter Picture
- Update Newsletter Settings
- Partner Actions
- Webhook Actions
- Webhook (More) Actions
- WhatsApp Status Actions
Partner → Create Instance or Preview
AI-generatedSummary
Create a new WhatsApp instance or preview its configuration via the Wafly Partner API, optionally using an idempotency key to ensure safe retries.
Inputs
- Idempotency Key — An optional string header required for the 'extra_instance_72h_v1' creation policy to safely retry creation requests without duplicating instances. Must be 8 to 128 characters using letters, digits, dots, hyphens, colons, or underscores.
- Body (JSON) (required) — A JSON object request body that can include fields such as acceptAutomaticBilling, creationPolicy, receivedCallbackUrl, deliveryCallbackUrl, disconnectedCallbackUrl, and messageStatusCallbackUrl to configure the instance creation or preview.
Output shape
a single JSON object representing the created instance or its preview data
The output includes the API response from the Partner service's create instance endpoint in JSON format. Use the same idempotency key and body for retries to avoid duplicate instance creation if using the 'extra_instance_72h_v1' policy.