patch
https://api.callhub.io/v1/p2p_campaigns//
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Change the status (start / pause / stop) or rename a P2P (Peer-to-Peer) campaign.
PATCH semantics: send only the fields you want to change. Both status and name are optional; at least one must be provided.
Status values
| Value | Meaning | Notes |
|---|---|---|
| 1 | START — run the campaign | Fails with 400 if no contacts, no caller ID, or pending approval |
| 2 | PAUSE — pause a running campaign | Campaign-list cache cleared on success |
| 4 | END — stop the campaign permanently | Cache cleared; recurring child occurrences are also ended |
Name editing while running
If the campaign is at status = 1 (START), name cannot be changed unless the same request also transitions out of START (status: 2 or status: 4). Otherwise returns 400 "Campaign must be stopped before it can be edited." — matches the rule the web UI enforces.