Menu

Expand
Rate this page:

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 SendGrid Pre-built Designs

GET /v3/designs/pre-builts

Base url: https://api.sendgrid.com

This endpoint allows you to retrieve a list of pre-built designs provided by Twilio SendGrid.

Unlike the /designs endpoint where your designs are stored, a GET request made to designs/pre-builts will retrieve a list of the pre-built Twilio SendGrid designs. This endpoint will not return the designs stored in your Design Library.

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.

This endpoint is useful for retrieving the IDs of Twilio SendGrid designs that you want to duplicate and modify.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required

Query String

page_size
integer

number of results to return

default: 100
page_token
string

token corresponding to a specific page of results, as provided by metadata

default: None
summary
boolean

set to false to return all fields

default: True

Responses

object
result
array[object]
id
string

ID of the Design.

format: uuid
updated_at
string

Datetime that Design was last updated.

format: ISO 8601 date-time
created_at
string

Datetime that Design was created.

format: ISO 8601 date-time
thumbnail_url
string

A Thumbnail preview of the template's html content.

name
string

The name of the new design.

default: Duplicate: <original design name>
editor
string

The editor used in the UI.

Allowed Values: code, design
_metadata
object
prev
string
format: uri
self
string
format: uri
next
string
format: uri
count
integer
minimum: 0
Loading Code Sample...
        
        

        List SendGrid Pre-built Designs

        Rate this page:

        Need 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.

        Loading Code Sample...
              
              
              

              Thank you for your feedback!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!

              thanks-feedback-gif