Skip to content

Schedule Campaign

POST /rest/v1/campaigns/{campaignId}/schedule.json

Permissions Execute Campaign

Build a request and mock the response

Method: POST
Path: /rest/v1/campaigns/{campaignId}/schedule.json
Tag: Campaigns
Operation ID: scheduleCampaignUsingPOST

Remotely schedules a batch campaign to run at a given time. My tokens local to the campaign's parent program can be overridden for the run to customize content. When using the "cloneToProgramName" parameter described below, this endpoint is limited to 20 calls per day. Required Permissions: Execute Campaign

Formats

  • Request: application/json
  • Response: application/json

Request

Path parameters

Name Type Required Description Constraints
campaignId integer (int32) Yes Id of the batch campaign to schedule.

Request body

Name: scheduleCampaignRequest
Required: No
Schema: model: ScheduleCampaignRequest

scheduleCampaignRequest

Generated example

{
  "input": {
    "cloneToProgramName": "Example name",
    "runAt": "2026-01-15T10:30:00Z",
    "tokens": [
      {
        "name": "Example name",
        "value": "string"
      }
    ]
  }
}

Referenced models

Example request

POST {{base_url}}/rest/v1/campaigns/{{campaignId}}/schedule.json
Content-Type: application/json
Accept: application/json

{
  "input": {
    "cloneToProgramName": "Example name",
    "runAt": "2026-01-15T10:30:00Z",
    "tokens": [
      {
        "name": "Example name",
        "value": "string"
      }
    ]
  }
}

Responses

200 — OK

Schema: model: ResponseOfCampaign

Generated example

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "nextPageToken": "example-token",
  "requestId": "123",
  "result": [
    {
      "active": false,
      "createdAt": "string",
      "description": "string",
      "id": 123,
      "name": "Example name",
      "programId": 123,
      "programName": "Example name",
      "type": "batch",
      "updatedAt": "string",
      "workspaceName": "Example name"
    }
  ],
  "success": false,
  "warnings": [
    {
      "code": 123,
      "message": "string"
    }
  ]
}

Referenced models

Source

Generated from swagger-mapi.json.

Generated examples are inferred from the schema. They are illustrative and may not be valid production payloads.