On this page

Update List

API Overview

Lists are static collections of Marketing Campaigns contacts. This API allows you to interact with the list objects themselves. To add contacts to a list, you must use the Contacts API.

You can also manage your lists using the Contacts menu in the Marketing Campaigns UI. For more information about lists and best practices for building them, see "Building your Contact List".

Operation overview

PATCH/v3/marketing/lists/{id}

Base url: https://api.sendgrid.com (The Twilio SendGrid v3 API)

This endpoint updates the name of a list.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

authorizationstring

required

Default: Bearer <<YOUR_API_KEY_HERE>>

Path parameters

Property nameTypeRequiredDescription

idstring

required

The ID of the list on which you want to perform the operation.

Request body

Encoding type:application/json

SchemaExample

Property nameTypeRequiredDescriptionChild properties

namestring

Optional

Your name for your list.

Responses

200400404

SchemaExample

Property nameTypeRequiredDescriptionChild properties

idstring

Optional

The generated ID for your list.

Min length: 36Max length: 36

namestring

Optional

The name you gave your list.

contactCountinteger

Optional

The number of contacts currently stored on the list.

MetadataselfMetadata

Optional

Show Metadata properties

Update List

1const client = require("@sendgrid/client");
2client.setApiKey(process.env.SENDGRID_API_KEY);
3
4const id = "id";
5const data = {
6  name: "updated-list-name",
7};
8
9const request = {
10  url: `/v3/marketing/lists/${id}`,
11  method: "PATCH",
12  body: data,
13};
14
15client
16  .request(request)
17  .then(([response, body]) => {
18    console.log(response.statusCode);
19    console.log(response.body);
20  })
21  .catch((error) => {
22    console.error(error);
23  });