Update Custom Opt-Out

This API allows you to update an existing Custom Opt-Out.

To view your Custom Opt-Outs, visit the Custom Opt-Out page in your Cellcast account.

Parameters for updating Custom Opt-Out

Headers Parameters

Parameters	Description
Authorization	Please add provided Bearer token - linked to your Cellcast account. Check here
Content-Type	application/json

Path Parameters

Parameters	Type	Description	Required
id	string	The ID of the custom opt-out to update	Yes

Body Parameters

Parameters	Type	Description	Required
title	string	Title of the custom opt-out	Yes
description	string	Description text for the opt-out page	Yes
options	array	Array of option strings for the opt-out survey	No

Code Samples

PUT https://api.cellcast.com/api/v1/apiClient/optoutlist/69130d39fa067342d5db81bb

cURL

curl --location --request PUT 'https://api.cellcast.com/api/v1/apiClient/optoutlist/69130d39fa067342d5db81bb' \
--header 'Content-Type: application/json' \
--header 'authorization: Bearer {{API_KEY}}' \
--data '{
    "title": "My Custom Opt Out Updated",
    "description": "We'\''re sorry to see you go! Are you still interested in any of these contents?",
    "options": ["Not interested", "Too many messages", "Spam", "Other reasons"]
}'

Replace with the actual API key that you own, and replace 69130d39fa067342d5db81bb with the ID of the custom opt-out you want to update.

Responses

200 Success

{
    "maintainence": 0,
    "new_version": 0,
    "force_update": 0,
    "invalid_token": 0,
    "refresh_token": "",
    "show_message": 0,
    "is_enc": false,
    "status": true,
    "message": "Optout list updated successfully",
    "message_type": "toast",
    "data": {
        "title": "My Custom Opt Out Updated",
        "description": "We're sorry to see you go! Are you still interested in any of these contents?",
        "options": [
            {
                "option1": "Not interested"
            },
            {
                "option2": "Too many messages"
            },
            {
                "option3": "Spam"
            },
            {
                "option4": "Other reasons"
            }
        ],
        "createdBy": "680f524350eb4e38fead5161",
        "createdAt": "2025-11-13T03:07:07.701Z",
        "updatedAt": "2025-11-13T03:09:41.072Z"
    },
    "error": {}
}

401 Unauthorized

{
  "code": 401,
  "message": "Token expired",
  "stack": "APIError: Token expired ...."
}

404 Not Found

{
  "status": false,
  "message": "Optout list not found",
  "error": {}
}

400 Bad Request

{
  "status": false,
  "message": "Validation error",
  "error": {
    "title": "Title is required"
  }
}