Update campaign | Atlas | Documentation

curl -X PUT https://api.youratlas.com/v1/api/campaign/id \
     -H "api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "campaignType": "outbound",
  "name": "Spring Sales Campaign"
}'

{
  "PartitionKey": "campaigns",
  "RowKey": "123e4567-e89b-12d3-a456-426614174000",
  "Timestamp": "2024-01-15T09:30:00Z",
  "odata.etag": "W/\"datetime'2024-01-15T09%3A30%3A00.0000000Z'\"",
  "name": "Spring Sales Campaign",
  "campaignType": "outbound",
  "Mode": true,
  "BusinessName": "GreenTech Solutions",
  "CallType": "automated",
  "CompanyName": "GreenTech Solutions",
  "FirstMessage": "Hello, this is an automated call from GreenTech Solutions.",
  "IsActive": true,
  "PhoneNumberId": "phone-7890",
  "Position": "Sales Representative",
  "ScriptBase": "Welcome to our Spring Sales event. How can I assist you today?",
  "ScriptNotes": "Focus on new product features and discounts.",
  "StartDate": "2024-01-15T09:30:00Z",
  "TimeWindows": "[{\"day\":\"Monday\",\"start\":\"09:00\",\"end\":\"17:00\"},{\"day\":\"Tuesday\",\"start\":\"09:00\",\"end\":\"17:00\"}]",
  "SuccessRequest": 150,
  "TemplateId": "template-456",
  "TotalRequest": 200,
  "TotalTransfers": 25,
  "DailyCallLimit": 100,
  "KnowledgeBaseId": "kb-123",
  "KnowledgeBaseDataSetId": "dataset-789",
  "FeatureAppendPreviousSummaryEnabled": true,
  "PhoneNumberProvider": "Twilio",
  "FeatureRescheduleCallEnabled": true,
  "EnrichmentInfoSettings": "{\"includeCustomerHistory\":true}",
  "EnrichmentInfoProvider": "hubspot",
  "FeatureEnrichmentInfoEnabled": true,
  "EndCallMessage": "Thank you for your time. Have a great day!",
  "VoicemailMessage": "Sorry we missed you. Please call us back at your convenience.",
  "AnalysisPlanSummaryPrompt": "Summarize the customer's interest and next steps.",
  "FeatureEndCallWhenVoicemail": true,
  "FeatureRedialOnNoResponse": true,
  "RedialSettings": "{\"maxAttempts\":3,\"intervalMinutes\":15}",
  "FeatureDoubleCall": true,
  "Timezone": "America/New_York",
  "TimezoneFriendlyName": "Eastern Standard Time",
  "Status": "archived",
  "Collection": "spring_campaigns",
  "IdleMessages": "[\"Are you still there?\",\"Please respond when ready.\"]",
  "ToolIds": "tool-123,tool-456",
  "SMSTrigger": "onMissedCall",
  "SMSBody": "We missed your call. Reply to schedule a callback.",
  "ForwardingPhoneNumber": "+1234567890",
  "PreScript": "Verify customer identity before proceeding.",
  "PostScript": "Log call outcome and schedule follow-up.",
  "FirstMessageMode": "assistant-speaks-first",
  "ChatPhoneNumberId": "chat-5678",
  "IsOutboundChatActive": true
}

Authentication

api-keystring

Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.

Path parameters

idstringRequired

The campaign ID

Request

This endpoint expects an object.

campaignTypeenumRequired

Allowed values:

namestringRequired

CallTypestringOptional

TemplateIdstringOptional

CompanyNamestringOptional

Injected as {{companyName}} in the script

PositionstringOptional

IsActivebooleanOptional

ModebooleanOptional

BusinessNamestringOptional

StartDatedatetimeOptional

TimeWindowsstringOptional

JSON string of time windows

FirstMessagestringOptional

Greeting the agent speaks at the start of every call

PreScriptstringOptional

PostScriptstringOptional

ScriptBasestringOptional

The agent's conversation script

ScriptNotesstringOptional

FeatureRescheduleCallEnabledbooleanOptional

FeatureEnrichmentInfoEnabledbooleanOptional

FeatureAppendPreviousSummaryEnabledbooleanOptional

EnrichmentInfoProviderenumOptional

Allowed values:

EnrichmentInfoSettingsstringOptional

JSON string of enrichment settings

TimezonestringOptional

TimezoneFriendlyNamestringOptional

StatusenumOptional

Allowed values:

CollectionstringOptional

ToolIdsstringOptional

Comma-separated tool IDs

SMSTriggerstringOptional

SMSBodystringOptional

FirstMessageModeenumOptional

Allowed values:

EndCallMessagestringOptional

VoicemailMessagestringOptional

AnalysisPlanSummaryPromptstringOptional

FeatureEndCallWhenVoicemailbooleanOptional

FeatureRedialOnNoResponsebooleanOptional

RedialSettingsstringOptional

JSON string of redial settings

FeatureDoubleCallbooleanOptional

DailyCallLimitintegerOptional

IdleMessagesstringOptional

JSON string of idle messages

IsOutboundChatActivebooleanOptional

Response

Campaign updated

PartitionKeystring

RowKeystring

Timestampdatetime

odata.etagstring

namestring

campaignTypestring

Modeboolean

BusinessNamestring

CallTypestring

CompanyNamestring

FirstMessagestring

IsActiveboolean

PhoneNumberIdstring

Positionstring

ScriptBasestring

ScriptNotesstring

StartDatedatetime

TimeWindowsstring

SuccessRequestinteger

TemplateIdstring

TotalRequestinteger

TotalTransfersinteger

DailyCallLimitinteger

KnowledgeBaseIdstring

KnowledgeBaseDataSetIdstring

Knowledge base dataset identifier

FeatureAppendPreviousSummaryEnabledboolean

PhoneNumberProviderstring

FeatureRescheduleCallEnabledboolean

EnrichmentInfoSettingsstring

EnrichmentInfoProviderstring

FeatureEnrichmentInfoEnabledboolean

EndCallMessagestring

VoicemailMessagestring

AnalysisPlanSummaryPromptstring

FeatureEndCallWhenVoicemailboolean

FeatureRedialOnNoResponseboolean

RedialSettingsstring

JSON string of redial attempt configuration

FeatureDoubleCallboolean

Timezonestring

TimezoneFriendlyNamestring

Statusenum

Allowed values:

Collectionstring

IdleMessagesstring

ToolIdsstring

SMSTriggerstring

SMSBodystring

ForwardingPhoneNumberstring

PreScriptstring

PostScriptstring

FirstMessageModeenum

Allowed values:

ChatPhoneNumberIdstring

IsOutboundChatActiveboolean

Errors

404

Not Found Error

500

Internal Server Error