> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Contact List by ID

[Back to API List](https://koreai.mintlify.site/ai-for-service/apis/contact-center/api-list)

Use this API to update a specific contact list associated with a campaign.

| Method | PUT |
| :- | :- |
| **Endpoint** | `https://{{host}}/agentassist/api/v1/public/{{IID}}/campaign/contactList/{{contactListId}}` |
| **Content-Type** | `application/json` |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token](https://koreai.mintlify.site/ai-for-service/apis/automation/api-introduction.md#generating-the-jwt-token). |
| **API Scope** | Campaign Management |

## Path Parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `host` | Environment URL, for example, `https://platform.kore.ai` | string, required |
| `IId` | The Application ID. | string, required |
| `contactListId` | Unique identifier of the contact list to update. | string, required |

## Sample Request

```bash theme={null}
curl --location 'https://{{host}}/agentassist/api/v1/public/{{IID}}/campaign/contactList/createContactList' \
--header 'auth: <token>' \
--header 'Content-Type: application/json' \
--header 'iid: st-0603182c-7ffb-53c3-b307-47ca14b9xxxx' \
--header 'accountId: 67777ce93e25326494e9xxxx' \
--data '{
    "name1": "Renewal Due - July 2025",
    "description": "This list contains customers with services expiring in July 2025. It includes contact details and subscription info to help agents provide tailored support during live calls.",
    "source": "passiveApiIntegration",
    "allowDuplicates": true
}'
```

## Headers

| Header | Description | Required/Optional |
| :- | :- | :- |
| `auth` | JWT token for authentication. | required |
| `iid` | The Application Id. | required |
| `accountId` | The Account Id. | required |

## Body Parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `name` | Updated name of the contact list. Maximum 48 characters. Used for identification and UI display. | string, optional |
| `description` | Updated description of the contact list. Maximum 256 characters. Should explain the purpose or content of the list. | string, optional |
| `allowDuplicates` | Whether to allow duplicate contact entries in the list. If omitted, the previous setting remains unchanged. | boolean, optional |

## Sample Response

```json theme={null}
{
    "status": "success",
    "message": "Contact list Renewal Due - August 2025 updated successfully",
    "data": {
        "contactListId": "cl-c2ce382-2516-457e-8eb4-9847deecxxxx",
        "body": {
            "name": "Renewal Due - August 2025",
            "orgId": "o-f8b351e7-f83a-51bd-bd42-d5d40861xxxx",
            "iId": "st-0603182c-7ffb-53c3-b307-47ca14b9xxxx",
            "listType": "call",
            "accountId": "67777ce93e25326494e9xxxx",
            "updatedBy": "u-eb5bbee1-6af9-5b9a-b471-03a3fe48xxxx"
        }
    }
}
```

## Response Body Parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `status` | Indicates the success or failure of the API call. | string |
| `message` | Message confirming the update operation. | string |
| `data` | Contains details of the updated contact list. | object |
| `data.contactListId` | Unique identifier of the contact list. | string |
| `data.body` | Object with updated metadata of the contact list. | object |
| `data.body.name` | Name of the contact list. | string |
| `data.body.orgId` | Unique identifier of the organization. | string |
| `data.body.iId` | Instance ID associated with the request context. | string |
| `data.body.listType` | Type of the list (for example, `call`, `sms`). | string |
| `data.body.accountId` | Identifier of the account to which the list belongs. | string |
| `data.body.updatedBy` | Identifier of the user who performed the update. | string |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.