How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Covatic Campaigns API

The Campaigns API from Covatic — 16 operation(s) for campaigns.

Covatic Campaigns API is one of 18 APIs that Covatic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Campaigns. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, authentication docs, and rate-limit docs.

This API exposes 20 operations across 16 paths, and defines 29 schemas. It is described by OpenAPI 3.2.0, at version 0.0.1.

Requests are made against a single base URL, https://prodaudiencebuilderapi.covatic.io.

20 operations 16 paths 29 schemas 2 DELETE10 GET3 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.0.1
Base URL
https://prodaudiencebuilderapi.covatic.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Covatic Campaigns API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 20

Across 16 paths, the API surfaces 20 operations — 2 DELETE, 10 GET, 3 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Campaigns 20
GET
/api/v1/campaigns/
Get Campaigns
get_campaigns_api_v1_campaigns__get 13 params → 200422
POST
/api/v1/campaigns/
Create New Campaign
create_new_campaign_api_v1_campaigns__post 2 params body → 201422
GET
/api/v1/campaigns/created-by
Get Campaign Created By
get_campaign_created_by_api_v1_campaigns_created_by_get 4 params → 200422
GET
/api/v1/campaigns/tracking-url
Get Tracking Url
get_tracking_url_api_v1_campaigns_tracking_url_get 2 params → 200422
GET
/api/v1/campaigns/{campaignId}/insights/summary
Get Campaign Insights Summary
get_campaign_insights_summary_api_v1_campaigns__campaignId__insights_summary_get 3 params → 200422
GET
/api/v1/campaigns/{campaignId}/insights/timeseries
Get Campaign Insights Timeseries
get_campaign_insights_timeseries_api_v1_campaigns__campaignId__insights_timeseries_get 3 params → 200422
GET
/api/v1/campaigns/{campaignId}/insights/targeting-changes
Get Campaign Insights Targeting Changes
get_campaign_insights_targeting_changes_api_v1_campaigns__campaignId__insights_targeting_changes_get 3 params → 200422
GET
/api/v1/campaigns/{campaignId}/insights/attribution
Get Campaign Attribution Insights
get_campaign_attribution_insights_api_v1_campaigns__campaignId__insights_attribution_get 3 params → 200422
POST
/api/v1/campaigns/{campaignId}/suggestions/{suggestionId}/dismiss
Dismiss Suggestion
dismiss_suggestion_api_v1_campaigns__campaignId__suggestions__suggestionId__dismiss_post 4 params body → 200422
POST
/api/v1/campaigns/{campaignId}/suggestions/{suggestionId}/accept
Accept Suggestion
accept_suggestion_api_v1_campaigns__campaignId__suggestions__suggestionId__accept_post 4 params → 200422
GET
/api/v1/campaigns/{campaignId}/history
Get Campaign History
get_campaign_history_api_v1_campaigns__campaignId__history_get 6 params → 200422
GET
/api/v1/campaigns/{campaignId}/suggestions
Get Campaign Suggestions
get_campaign_suggestions_api_v1_campaigns__campaignId__suggestions_get 3 params → 200422
POST
/api/v1/campaigns/{campaignId}/suggestions
Add Campaign Suggestions
add_campaign_suggestions_api_v1_campaigns__campaignId__suggestions_post 3 params body → 200422
PATCH
/api/v1/campaigns/{campaignId}/audiences/performance
Update Audience Performance
update_audience_performance_api_v1_campaigns__campaignId__audiences_performance_patch 3 params body → 200422
POST
/api/v1/campaigns/{campaignId}/audiences
Bulk Add Audiences
bulk_add_audiences_api_v1_campaigns__campaignId__audiences_post 3 params body → 200422
DELETE
/api/v1/campaigns/{campaignId}/audiences/{audienceCode}
Remove Audience
remove_audience_api_v1_campaigns__campaignId__audiences__audienceCode__delete 4 params body → 200422
GET
/api/v1/campaigns/{campaignId}
Get Campaign Detail
get_campaign_detail_api_v1_campaigns__campaignId__get 3 params → 200422
PATCH
/api/v1/campaigns/{campaignId}
Update Existing Campaign
update_existing_campaign_api_v1_campaigns__campaignId__patch 3 params body → 200422
DELETE
/api/v1/campaigns/{campaignId}
Delete Existing Campaign
delete_existing_campaign_api_v1_campaigns__campaignId__delete 3 params → 204422
PATCH
/api/v1/campaigns/{campaignId}/status
Update Campaign Status Endpoint
update_campaign_status_endpoint_api_v1_campaigns__campaignId__status_patch 3 params body → 200422

Schemas 29

The contract defines 29 schemas that model the data the API accepts and returns. The most detailed are CampaignCreateRequest (15 properties), CampaignUpdateRequest (14 properties), SmartCampaign (8 properties), SmartCampaignSuggestion (8 properties). Each schema is shown below with its type and property counts.

CampaignStatus
string
Campaign status enumeration
CampaignCreateRequest
object
Request model for creating a campaign
15 properties 2 required
Page_str_
object
5 properties 5 required
BulkAddAudienceItem
object
Single audience item for bulk add
3 properties 2 required
SuggestionDismissalRequest
object
Request body for dismissing a suggestion
1 property
SmartCampaign
object
Smart campaign configuration with performance tracking and suggestions
8 properties 2 required
RecommendationCadence
string
Controls how often the AI generates audience suggestions for Smart Campaigns
CampaignType
string
Campaign type enumeration
ValidationError
object
5 properties 3 required
CampaignStatusUpdateRequest
object
Request model for updating campaign status only
1 property 1 required
AdEngine
string
Ad engine enumeration - different ad serving platforms
SmartCampaignAudience
object
Audience information for smart campaign with performance tracking
4 properties 3 required
CampaignOutcome
string
Campaign outcome enumeration - trackable outcomes/events for attribution campaigns
models__profile__Response
object
4 properties 4 required
CampaignUpdateRequest
object
Request model for updating a campaign (partial update)
14 properties
SuggestionStatus
string
Suggestion status enumeration
SimpleCampaign
object
Simple campaign configuration with audience data
6 properties 2 required
UpdatePerformanceRequest
object
Request body for updating performance
1 property 1 required
AddSuggestionsRequest
object
Request body for adding suggestions
1 property 1 required
Pixel
object
Individual pixel tracking code for an ad engine
4 properties 3 required
HTTPValidationError
object
1 property
SmartCampaignSuggestion
object
Suggested audience for smart campaign
8 properties 3 required
OutcomePixel
object
Outcome with associated pixels
2 properties 1 required
SimpleCampaignAudience
object
Audience information for simple campaign
3 properties 3 required
PerformanceRating
string
Performance rating enumeration for audience performance tracking
BulkAddAudiencesRequest
object
Request body for bulk adding audiences to a smart campaign
1 property 1 required
PerformanceUpdate
object
Single performance update
2 properties 2 required
AudienceRemovalRequest
object
Request body for removing an audience
1 property
AddSuggestionItem
object
Single suggestion item to add
6 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

covatic-campaigns-api-openapi.yml Raw ↑

Other APIs Covatic publishes across the network.

Covatic Audience Builder Agent API
Covatic Audience Builder API
Covatic Auth API
Covatic Chat GPT API
Covatic Commons API
Covatic Company API
Covatic Event Traits API
Covatic Insights API
Covatic Notes API
Covatic Profiles API
Covatic QA and Debug API
Covatic Retargeting Traits API
Where this information came from

This is an independent, third-party profile of Covatic Campaigns API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.