# Duplicate SendGrid Pre-built Design ## API Overview The Designs API offers the ability to manage assets stored in the Twilio SendGrid [Design Library](https://mc.sendgrid.com/design-library/my-designs). The Design Library is a feature-rich email layout tool and media repository. You can [build designs for all your email needs](/docs/sendgrid/ui/sending-email/working-with-marketing-campaigns-email-designs/), 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. ## Operation overview ```json {"path":"https://api.sendgrid.com/v3/designs/pre-builts/{id}","method":"post","servers":[{"url":"https://api.sendgrid.com","description":"for global users and subusers"},{"url":"https://api.eu.sendgrid.com","description":"for EU regional subusers"}]} ``` **This endpoint allows you to duplicate one of the pre-built Twilio SendGrid designs**. Like duplicating one of your existing designs, you are not required to pass any data in the body of a request to this endpoint. If you choose to leave the `name` field blank, your duplicate will be assigned the name of the design it was copied from with the text "Duplicate: " prepended to it. This name change is only a convenience, as the duplicate design will be assigned a unique ID that differentiates it from your other designs. You can retrieve the IDs for Twilio SendGrid pre-built designs using the "List SendGrid Pre-built Designs" endpoint. You can modify your duplicate’s name at the time of creation by passing an updated value to the `name` field when making the initial request. More on retrieving design IDs can be found above. ## Operation details ### Authentication API Key ### Headers ```json [{"in":"header","name":"Authorization","required":true,"default":"Bearer <>","schema":{"type":"string"}}] ``` ### Path parameters ```json [{"name":"id","in":"path","description":"The ID of the pre-built Design you want to duplicate.","required":true,"schema":{"type":"string","format":"uuid"}}] ``` ### Request body ```json {"schema":{"title":"Design Duplicate Design Input","type":"object","example":{"name":"Ahoy, Cake or Pie Cafe!","editor":"design"},"refName":"DesignDuplicateInput","modelName":"DesignDuplicateInput","properties":{"name":{"type":"string","description":"The name of the new design.","default":"Duplicate: "},"editor":{"type":"string","description":"The editor used in the UI.","enum":["code","design"],"refName":"Editor","modelName":"Editor"}}},"encodingType":"application/json"} ``` ### Responses ```json [{"responseCode":"200","schema":{"description":"","content":{"application/json":{"schema":{"title":"Design Output","type":"object","required":["html_content"],"refName":"DesignOutput","modelName":"DesignOutput","properties":{"name":{"type":"string","description":"The name of the new design.","default":"Duplicate: "},"editor":{"type":"string","description":"The editor used in the UI.","enum":["code","design"],"refName":"Editor","modelName":"Editor"},"html_content":{"type":"string","description":"The HTML content of the Design.","maxLength":1048576},"plain_content":{"type":"string","description":"Plain text content of the Design.","maxLength":1048576,"default":""}}},"examples":{"response":{"value":{"id":"abe0877f-a224-21e2-b62e-c789d326cda5","name":"Ahoy, Pre-built Design!","html_content":"\n\n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n

\n \n \n \n \n

\n \n \n \n \n \n

\n \n \n \n

You've found the secret!

\n \n \n \n

$\"Off$

\n \n \n \n

$\"\"$

\n \n \n \n

Welcome to the family!

\n \n \n \n

You've found a community of travelers that are just like you.

We don't want to be stuck in tourist traps that isolate us from vibrant, local experiences. We want to discover the hidden gems and less-traveled roads of our next destination.

Ready for your next authentic travel experience?

Browse Gallery

\n \n \n \n

$\"\"$

\n \n \n \n

\n \n \n \n \n

\n \n \n \n

\n \n \n \n \n \n

\n \n \n

{{Sender_Address}}, {{Sender_City}}, {{Sender_State}} {{Sender_Zip}}

Unsubscribe - Unsubscribe Preferences

\n \n

\n \n \n ","plain_content":"You've found the secret!\n\nWelcome to the family!\n\nYou've found a community of travelers that are just like you.\n\nWe don't want to be stuck in tourist traps that isolate us from vibrant, local experiences. We want to discover the hidden gems and less-traveled roads of our next destination.\n\nReady for your next authentic travel experience?\n\nBrowse Gallery\n\n( https://www.facebook.com/sendgrid/ ) ( https://twitter.com/sendgrid?ref_src=twsrc%5egoogle%7ctwcamp%5eserp%7ctwgr%5eauthor ) ( https://www.instagram.com/sendgrid/?hl=en ) ( https://www.pinterest.com/sendgrid/ )\n\n{{Sender_Name}}\n\n{{Sender_Address}} , {{Sender_City}} , {{Sender_State}} {{Sender_Zip}}\n\nUnsubscribe ( {{{unsubscribe}}} ) - Unsubscribe Preferences ( {{{unsubscribe_preferences}}} )","generate_plain_content":true,"thumbnail_url":"//us-east-2-production-thumbnail-bucket.s3.amazonaws.com/a85b4b202ff28094828f11ff472360caecf67ead2d186b69b45c904b9251aa0b.png","subject":"Welcome to the family!","created_at":"2021-04-30T19:15:28Z","updated_at":"2021-04-30T19:15:28Z","editor":"design","categories":[]}}}}}}},{"responseCode":"400","schema":{"description":"","content":{"application/json":{"schema":{"title":"errors","type":"object","refName":"ApiErrors","modelName":"ApiErrors","properties":{"errors":{"type":"array","items":{"title":"error","type":"object","required":["message","field","error_id"],"refName":"ApiError","modelName":"ApiError","properties":{"message":{"type":"string"},"field":{"type":"string"},"error_id":{"type":"string"}}}}}}}}}},{"responseCode":"404","schema":{"description":"","content":{"application/json":{"schema":{"title":"errors","type":"object","refName":"ApiErrors","modelName":"ApiErrors","properties":{"errors":{"type":"array","items":{"title":"error","type":"object","required":["message","field","error_id"],"refName":"ApiError","modelName":"ApiError","properties":{"message":{"type":"string"},"field":{"type":"string"},"error_id":{"type":"string"}}}}}}}}}}] ``` Duplicate SendGrid Pre-built Design ```js const client = require("@sendgrid/client"); client.setApiKey(process.env.SENDGRID_API_KEY); const id = "f15982c1-a82c-4e87-a6b2-a4a63b4b7644"; const data = { name: "Ahoy, Cake or Pie Cafe!", editor: "design", }; const request = { url: `/v3/designs/pre-builts/${id}`, method: "POST", body: data, }; client .request(request) .then(([response, body]) => { console.log(response.statusCode); console.log(response.body); }) .catch((error) => { console.error(error); }); ``` ```python import os from sendgrid import SendGridAPIClient sg = SendGridAPIClient(os.environ.get("SENDGRID_API_KEY")) id = "f15982c1-a82c-4e87-a6b2-a4a63b4b7644" data = {"name": "Ahoy, Cake or Pie Cafe!", "editor": "design"} response = sg.client._(f"designs/pre-builts/{id}").post(request_body=data) print(response.status_code) print(response.body) print(response.headers) ``` ```csharp using System; using System.Collections.Generic; using System.Threading.Tasks; using SendGrid; public class Program { public static async Task Main() { string apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY"); var client = new SendGridClient(apiKey); var id = "f15982c1-a82c-4e87-a6b2-a4a63b4b7644"; var data = @"{ ""name"": ""Ahoy, Cake or Pie Cafe!"", ""editor"": ""design"" }"; var response = await client.RequestAsync( method: SendGridClient.Method.POST, urlPath: $"designs/pre-builts/{id}", requestBody: data); Console.WriteLine(response.StatusCode); Console.WriteLine(response.Body.ReadAsStringAsync().Result); Console.WriteLine(response.Headers.ToString()); } } ``` ```java import com.sendgrid.*; import java.io.IOException; import org.json.JSONObject; import java.util.HashMap; import java.util.Arrays; public class Example { public static void main(String[] args) throws IOException { try { SendGrid sg = new SendGrid(System.getenv("SENDGRID_API_KEY")); Request request = new Request(); request.setMethod(Method.POST); request.setEndpoint("/designs/pre-builts/f15982c1-a82c-4e87-a6b2-a4a63b4b7644"); request.setBody(new JSONObject(new HashMap() { { put("name", "Ahoy, Cake or Pie Cafe!"); put("editor", "design"); } }).toString()); Response response = sg.api(request); System.out.println(response.getStatusCode()); System.out.println(response.getBody()); System.out.println(response.getHeaders()); } catch (IOException ex) { throw ex; } } } ``` ```go package main import ( "fmt" "github.com/sendgrid/sendgrid-go" "os" ) func main() { apiKey := os.Getenv("SENDGRID_API_KEY") host := "https://api.sendgrid.com" request := sendgrid.GetRequest(apiKey, "/v3/designs/pre-builts/f15982c1-a82c-4e87-a6b2-a4a63b4b7644", host) request.Method = "POST" request.Body = []byte(`{ "name": "Ahoy, Cake or Pie Cafe!", "editor": "design" }`) response, err := sendgrid.API(request) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { fmt.Println(response.StatusCode) fmt.Println(response.Body) fmt.Println(response.Headers) } } ``` ```php /sendgrid-php.php'; $apiKey = getenv("SENDGRID_API_KEY"); $sg = new \SendGrid($apiKey); $request_body = json_decode('{ "name": "Ahoy, Cake or Pie Cafe!", "editor": "design" }'); $id = "f15982c1-a82c-4e87-a6b2-a4a63b4b7644"; try { $response = $sg->client->_("designs/pre-builts/{$id}")->post($request_body); print $response->statusCode() . "\n"; print_r($response->headers()); print $response->body() . "\n"; } catch (Exception $ex) { echo "Caught exception: " . $ex->getMessage(); } ``` ```ruby require 'sendgrid-ruby' include SendGrid sg = SendGrid::API.new(api_key: ENV['SENDGRID_API_KEY']) data = JSON.parse('{ "name": "Ahoy, Cake or Pie Cafe!", "editor": "design" }') id = "f15982c1-a82c-4e87-a6b2-a4a63b4b7644" response = sg.client._("designs/pre-builts/#{id}").post(request_body: data) puts response.status_code puts response.headers puts response.body ``` ```bash curl -X POST "https://api.sendgrid.com/v3/designs/pre-builts/f15982c1-a82c-4e87-a6b2-a4a63b4b7644" \ --header "Authorization: Bearer $SENDGRID_API_KEY" \ --header "Content-Type: application/json" \ --data '{"name": "Ahoy, Cake or Pie Cafe!", "editor": "design"}' ```