Bulk Activities

Delete Contact Lists

Changed on

Use this endpoint to delete up to 100 contact lists in an account.

post/activities/list_delete

Request

  • Base URL
    https://api.cc.email/v3
  • URL
    https://api.cc.email/v3/activities/list_delete
  • Auth
    • OAuth 2
      Implicit: https://authz.constantcontact.com/oauth2/default/v1/authorize
      Scopes: contact_data
    • or OAuth 2
      Authorization code: https://authz.constantcontact.com/oauth2/default/v1/authorize
      Token URL: https://authz.constantcontact.com/oauth2/default/v1/token scopes: contact_data

Request body

list_idsstring[] required

The array of contact lists <code>list_id</code> to delete.

Example request

{
  "list_ids": [
    "04fe9a97-a579-43c5-bb1a-58ed29bf0a6a"
  ]
}

Response

Request successful. Activity queued for processing.

activity_idstring

The system assigned UUID that uniquely identifies an activity.

statestring

The activity processing state.

started_atstring date-time

Timestamp showing when processing started for the activity, in ISO-8601 format.

completed_atstring date-time

Timestamp showing when processing completed for the activity, in ISO-8601 format.

created_atstring date-time

Timestamp showing when the activity was first requested, in ISO-8601 format.

updated_atstring date-time

Timestamp showing when the activity was last updated, in ISO-8601 format.

percent_doneinteger

The processing percent complete for the activity.

activity_errorsstring[]

An array of error message strings describing the errors that occurred.

Example response

{
  "activity_id": "af86135c-8740-11eb-8abf-fa163ef30864",
  "state": "initialized",
  "started_at": "2019-12-12T15:38:24Z",
  "completed_at": "2019-12-12T15:38:24Z",
  "created_at": "2019-12-12T15:38:24Z",
  "updated_at": "2019-12-12T15:38:24Z",
  "percent_done": 25,
  "activity_errors": [
    "Message describing the error condition."
  ],
  "status": {
    "list_count": 5
  },
  "_links": {
    "self": {
      "href": "/v3/activities/04fa57a7-cf55-4185-cc1a-58ed29bf0a6a"
    }
  }
}

Changes