---
title: "Cancel a callback"
method: DELETE
path: "/companies/{company_key}/config/callbacks/{callback_id}"
tags: ["Callback API"]
---

# Cancel a callback

`DELETE /companies/{company_key}/config/callbacks/{callback_id}`

## Request

- Base URL: `https://public-api.vibescm.com`
- URL: `https://public-api.vibescm.com/companies/{company_key}/config/callbacks/{callback_id}`
- Auth: HTTP basic

## Path parameters

- `company_key` string, required
- `callback_id` string, required

## Headers

- `X-API-Version` string
- `Content-Type` string, required

## Response `200`

Callback was successfully cancelled. Your endpoint will no longer receive this callback.

- CallbackResponse
  - `callback_id` string: Vibes unique identifier for each callback record.
  - `callback_type` string: Callback type to trigger this callback.
  - `ack_participant_changed` object: Present for Acquisition Changed callback.
    - `campaign_id` string: Vibes unique identifier for an acquisition campaign.
  - `ack_participant_added` object: Present for Acquisition Added callback.
    - `campaign_id` string: Vibes unique identifier for an acquisition campaign.
  - `subscription_added` object: Present for Subscription Added callback.
    - `list_id` string: Vibes unique identifier for a subscription list.
  - `subscription_removed` object: Present for Subscription Removed callback.
    - `list_id` string: Vibes unique identifier for a subscription list.
  - `unmatched_message_received` object: Present for Unmatched Message callback.
    - `source_code` string: The short code, long code, or alpha code you want to receive unmatched message events for.
    - `country_code` string: The country code for the source code you want to receive unmatched message events for.
  - `wallet_item_install` object: Present for Wallet Item Install callback.
    - `campaign_token` string: The campaign token for the wallet campaign.
  - `wallet_item_remove` object: Present for Wallet Item Removed callback.
    - `campaign_token` string: The campaign token for the wallet campaign.
  - `device_added` object: Present for Push Device Added callback.
    - `app_id` string: Your push application id.
  - `device_removed` object: Present for Push Device Removed callback.
    - `app_id` string: Your push application id.
  - `device_updated` object: Present for Push Device Updated callback.
    - `app_id` string: Your push application id.
  - `event_processed` object: Present for event-triggered callback if you only want to recieve callbacks for a single event.
    - `event_type` string
    - `callbacks_to_send` 'all' | 'only_failures' | 'routing' | 'carrier_dlr' | 'handset_dlr': Choose which callbacks you'd like to receive. Default is all.
  - `destination` object
    - `url` string: External URL to submit the callback data.
    - `method` 'POST' | 'PUT': Method to submit the data to the destination URL.
    - `content_type` 'application/json' | 'text/json': Content type to set when submitting the data to the destination URL.
  - `start_date` string: The date the campaign is starting in ISO-8601 format.
  - `end_date` string: The date the Campaign is ending in ISO-8601 format.
  - `url` string: Unique resource URL for the callback.
  - `created_date` string: The date the campaign was created in ISO-8601 format.
  - `updated_date` string: The date the campaign was last updated in ISO-8601 format.

## Other responses

- `404`: The `callback_id` cannot be found.

---

[API](https://skmtc.dev/vibes/apis/vibes-platform-api.md) - [All operations](https://skmtc.dev/vibes/apis/vibes-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vibes/apis/vibes-platform-api/revisions/e235838f2e50?raw)