Content Builder API

Overview

Marketers use Content Builder in Marketing Cloud as a single cross-channel repository for marketing content, such as emails, images, text, and other documents.

Marketing developers, service providers, and third-party developers can create and manipulate marketing content using the Content Builder REST API.

The API uses the term asset to refer to all types of marketing content. Assets are hierarchical; an asset can be a message that contains a template, which is itself an asset. The template can contain slots, which are also assets. Assets are stored in both ElasticSearch and in SQL Server; ElasticSearch provides a fast document retrieval engine, while SQL Server provides the reliability Salesforce is famous for. Use the asset model described in this documentation to create, update, delete, query for, and publish assets.

API Specification

These tables include the most commonly used REST resources that make up the Content Builder API.

HTTP MethodResourceDescription
POST/asset/v1/content/assets/queryGets an asset collection by advanced query.
GET/asset/v1/content/assets/{id}Gets an asset by ID.
POST/asset/v1/content/assetsInserts an asset.
PUT/asset/v1/content/assets/{id}Updates a full asset.
PATCH/asset/v1/content/assets/{id}Updates part of an asset.
DELETE/asset/v1/content/assets/{id}Deletes an asset.
GET/asset/v1/content/assets/{id}/fileGets the binary file for an asset.
GET/asset/v1/content/assets/salutationsGets the default header and footer for an account.
GET/asset/v1/content/assets/{id}/salutationsGets the header and footer for a message.
GET/asset/v1/content/assets/{id}/channelviews/{viewname}Returns the requested channel view's compiled HTML for the asset.
POST/asset/v1/content/categoriesInserts a category.
GET/asset/v1/content/categoriesGets a collection of categories.
GET/asset/v1/content/categories/{id}Gets a category by ID.
PUT/asset/v1/content/categories/{id}Updates a category by ID.
DELETE/asset/v1/content/categories/{id}Deletes a category by ID.
GET/asset/v1/content/deletedAssetsReturns a collection of all assets deleted in the last 30 days.
PATCH/asset/v1/content/deletedAssets/AssetIDUpdates part of a deleted asset.