Designs API
The Designs API offers the ability to manage assets stored in the Twilio SendGrid Design Library.
The Design Library is a feature-rich email layout tool and media repository. You can build designs for all your email needs, including Single Sends, Automations, and Dynamic Templates.
You can also duplicate and then modify one of the pre-built designs provided by Twilio SendGrid to get you started.
The Designs API provides a RESTful interface for creating new designs, retrieving a list of existing designs, duplicating or updating a design, and deleting a design.
List Designs
GET /v3/designs
Base url: https://api.sendgrid.com
This endpoint allows you to retrieve a list of designs already stored in your Design Library.
A GET request to /designs
will return a list of your existing designs. This endpoint will not return the pre-built Twilio SendGrid designs. Pre-built designs can be retrieved using the /designs/pre-builts
endpoint, which is detailed below.
By default, you will receive 100 results per request; however, you can modify the number of results returned by passing an integer to the page_size
query parameter.
Authentication
- API Key
Headers
Query String
number of results to return
default: 100token corresponding to a specific page of results, as provided by metadata
default: Noneset to false to return all fields
default: TrueResponses
ID of the Design.
format: uuidDatetime that Design was last updated.
format: ISO 8601 date-timeDatetime that Design was created.
format: ISO 8601 date-timeA Thumbnail preview of the template's html content.
The name of the new design.
default: Duplicate: <original design name>The editor used in the UI.
Allowed Values: code, designNeed some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.