# Ringover Campaigns API

**Canonical:** https://apis.io/apis/ringover/ringover-campaigns-api/  
**Provider:** Ringover — https://apis.io/providers/ringover/  
**Base URL:** https://public-api.ringover.com/v2  
**Documentation:** https://developer.ringover.com/

Ringover Campaigns API is one of 28 APIs that [Ringover](https://apis.io/providers/ringover/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include campaigns. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage your outbound call campaigns (Call Lists). This section provides a comprehensive overview of how to manage your campaign workflows: - Retrieve the list of campaigns, filterable by various parameters. - Assign Ringover users to specific campaigns. - Add or manage contacts associated with a campaign. - Start, stop, or reset campaigns dynamically. - Update campaign scripts to ensure consistent messaging. - Adjust the number of allowed call retries for specific campaigns. - Modify tags assigned to campaigns to enhance your tracking. - Manage numbers associated with campaigns, including: adding, updating, or removing them. - Extend the capabilities of your campaigns by adding custom columns (enriched data). **Permissions:** No specific permission required. A valid API key is sufficient to access all campaign routes. **Monitoring impact:** None.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/campaigns/call` | List all outbound call campaigns |
| GET | `/campaigns/call/user` | List active campaigns assigned to the current user |
| GET | `/campaigns/call/{campaignscalllistuuid}` | Get a specific campaign by UUID |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/start` | Start a campaign |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/start/edit` | Edit a campaign's scheduled start date |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/stop` | Stop a running campaign |
| POST | `/campaigns/call/{campaignscalllistuuid}/reset` | Reset a campaign to its initial state |
| GET | `/campaigns/call/{campaignscalllistuuid}/numbers` | List contacts in a campaign's call queue |
| POST | `/campaigns/call/{campaignscalllistuuid}/numbers` | Add contacts to a campaign's call queue |
| DELETE | `/campaigns/call/{campaignscalllistuuid}/numbers` | Remove contacts from a campaign's call queue |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/numbers` | Update metadata for campaign contacts |
| POST | `/campaigns/call/{campaignscalllistuuid}/numbers/columns` | Add a custom data column to campaign contacts |
| DELETE | `/campaigns/call/{campaignscalllistuuid}/numbers/columns` | Delete a custom data column from campaign contacts |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/numbers/columns/rename` | Rename a custom data column in campaign contacts |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/numbers/columns/switch` | Swap the position of two custom columns |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/name/{newname}` | Rename a campaign |
| PATCH | `/campaigns/call/{campaignscalllistuuid}/maxretry/{newMaxRetry}` | Update maximum retry attempts |
| GET | `/campaigns/call/{campaignscalllistuuid}/groups` | List groups assigned to a campaign |
| POST | `/campaigns/call/{campaignscalllistuuid}/groups` | Assign groups to a campaign |
| DELETE | `/campaigns/call/{campaignscalllistuuid}/groups` | Remove groups from a campaign |
| GET | `/campaigns/call/{campaignscalllistuuid}/users` | List users assigned to a campaign |
| POST | `/campaigns/call/{campaignscalllistuuid}/users` | Assign individual users to a campaign |
| DELETE | `/campaigns/call/{campaignscalllistuuid}/users` | Remove users from a campaign |
| PUT | `/campaigns/call/{campaignscalllistuuid}/tags` | Replace all tags on a campaign |
| DELETE | `/campaigns/call/{campaignscalllistuuid}/tags` | Remove all tags from a campaign |
| DELETE | `/campaigns/call/{campaignscalllistuuid}/tags/{tagID}` | Remove a specific tag from a campaign |
| PUT | `/campaigns/call/{campaignscalllistuuid}/script` | Assign or remove a call script |
| GET | `/campaigns/call/{campaignscalllistuuid}/logs` | Get campaign audit logs |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/ringover/openapi/ringover-campaigns-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-calls-filter-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-empower-logs-calls-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-empower-logs-calls-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-call-empower-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-conversation-light-schema.json
- **JSONSchema** — https://artifacts.apis.io/ringover/json-schema/ringover-get-call-empower-res-body-schema.json

## Other Ringover APIs (12)

- [Ringover Blacklist API](https://apis.io/apis/ringover/ringover-blacklist-api/)
- [Ringover Callbacks API](https://apis.io/apis/ringover/ringover-callbacks-api/)
- [Ringover Calls API](https://apis.io/apis/ringover/ringover-calls-api/)
- [Ringover Cdn API](https://apis.io/apis/ringover/ringover-cdn-api/)
- [Ringover Channels API](https://apis.io/apis/ringover/ringover-channels-api/)
- [Ringover Conferences API](https://apis.io/apis/ringover/ringover-conferences-api/)
- [Ringover Contacts API](https://apis.io/apis/ringover/ringover-contacts-api/)
- [Ringover Conversations API](https://apis.io/apis/ringover/ringover-conversations-api/)
- [Ringover Empower API](https://apis.io/apis/ringover/ringover-empower-api/)
- [Ringover Groups API](https://apis.io/apis/ringover/ringover-groups-api/)
- [Ringover Ivrs API](https://apis.io/apis/ringover/ringover-ivrs-api/)
- [Ringover MCP API](https://apis.io/apis/ringover/ringover-mcp-api/)

## Tags

campaigns

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ringover/ringover-campaigns-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ringover/.