Skip to main content
A testing group organizes trial messages. It does not own a physical sending number or receive a separate allowance. Public API paths use the name trial-campaigns; these customer groups are separate from staff-managed carrier registrations. Every group contains id, name, state (active or closed), created_at and nullable closed_at. Timestamps use UTC. Foreign or absent IDs return 404 trial_not_found.

​
Create a group

The body accepts only name: nonempty text after trimming, at most 200 characters. Creation requires an active eligible trial and enabled new-work availability. Sandbox keys cannot create or close groups.

​
Browse and inspect

The default page size is 50; limit accepts 1 through 100. Pass the returned opaque next_cursor as the next request’s cursor query parameter. Do not interpret or construct cursors.

​
Close a group

Closure fences new submissions and recoverably cancels queued reservations. It preserves history, used allowance and permanent conversation ownership. An attempted message may still arrive. Reads and closure remain available when new trial work is disabled, subject to normal authorization and backend availability. Malformed input returns 400 trial_invalid_request; disabled new work returns 403 trial_disabled; an ended or ineligible trial returns 403 trial_inactive; a competing revision can return 409 trial_revision_conflict; unavailable authority returns 503 trial_unavailable. Refresh before retrying a conflict. The dashboard uses session authentication and permits only account owners to create or close groups. These public API-key scopes and send contracts remain unchanged.