---
title: "POST /v1/Consents/Bulk"
method: POST
path: "/v1/Consents/Bulk"
tags: ["AccountsV1BulkConsents"]
---

# POST /v1/Consents/Bulk

`POST /v1/Consents/Bulk`

## Request

- Base URL: `https://accounts.twilio.com`
- URL: `https://accounts.twilio.com/v1/Consents/Bulk`
- Auth: HTTP basic

## Request body `application/x-www-form-urlencoded`

- object
  - `Items` unknown[], required: This is a list of objects that describes a contact's opt-in status. Each object contains the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID used to uniquely map the request item with the response item; `sender_id`, which can be either a valid messaging service SID or a from phone number; `status`, a string representing the consent status. Can be one of [`opt-in`, `opt-out`]; `source`, a string indicating the medium through which the consent was collected. Can be one of [`website`, `offline`, `opt-in-message`, `opt-out-message`, `others`]; `date_of_consent`, an optional datetime string field in ISO-8601 format that captures the exact date and time when the user gave or revoked consent. If not provided, it will be empty.
    - unknown

## Response `201`

Created

- AccountsV1BulkConsents
  - `items` unknown

## Changes

- **2025-07-03** (v1) `19ae03b8bc0f`: 1 breaking, 1 info
  - the `items` response's property type changed from `object` to no type for status `201`
  - the `Items/items/` request property type was generalized from `object` to no type
- **2025-03-11** (v1) `8ac02c4c30e2`: 2 breaking
  - the `Items/items/` request property type changed from no type to `object`
  - the `items` response's property type changed from no type to `object` for status `201`
- **2024-09-25** (v1) `4871bc55ef74`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twilio/apis/accounts-v1/changes/v1/Consents/Bulk/post.md)

---

[API](https://skmtc.dev/twilio/apis/accounts-v1.md) - [All operations](https://skmtc.dev/twilio/apis/accounts-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/accounts-v1/revisions/a21ff11add2e?raw)