Skip to main content

Create brand

URL: https://api.courier.com/brands

Method: POST

Body Parameters

idstring
Brand Identifier
namestringrequired
Brand name
settingsobject
+ Show Properties
snippetsobject
+ Show Properties

Responses

status: 200 OK

creatednumber
The date/time of when the brand was created. Represented in milliseconds since Unix epoch.
idstring
Brand Identifier
namestringrequired
Brand name
publishednumber
The date/time of when the brand was published. Represented in milliseconds since Unix epoch.
settingsobject
+ Show Properties
updatednumber
The date/time of when the brand was updated. Represented in milliseconds since Unix epoch.
snippetsobject
+ Show Properties
versionstring
The version identifier for the brand

status: 400 Bad Request

messagestring
A message describing the error that occurred.
typestring
[invalid_request_error] The type of error that occurred.

status: 402 Payment Required

messagestring
A message describing the error that occurred.
typestring
[authorization_error] The type of error that occurred.

status: 409 Already Exists

messagestring
A message describing the error that occurred.
typestring
[invalid_request_error] The type of error that occurred.

Request Example

curl --request POST \
--url https://api.courier.com/brands \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '
{
"id": "C8CPX6HQZ5M7Q5KAMW5CXC4N98DH",
"name": "Example Brand Name",
"settings": {
"colors": {
"primary": "#9D3789",
"secondary": "#9D3789",
"tertiary": "#9D3789"
},
"email": {
"footer": {
"markdown": "**Bold** and _italic_ with a [link](https://www.courier.com)",
"social": {
"facebook": {
"url": "https://www.facebook.com/example"
},
"instagram": {
"url": "https://www.instagram.com/example"
},
"linkedin": {
"url": "https://www.linkedin.com/example"
},
"medium": {
"url": "https://www.medium.com/example"
},
"twitter": {
"url": "https://www.twitter.com/example"
}
}
},
"header": {
"barColor": "#9D3789",
"logo": {
"href": "https://www.courier.com",
"image": "https://www.courier.com/logo.png"
}
}
}
}
}
'

Responses Example

{
"created": 1591753605265,
"id": "C8CPX6HQZ5M7Q5KAMW5CXC4N98DH",
"name": "Example Brand Name",
"published": 1591753605265,
"settings": {
"colors": {
"primary": "#9D3789",
"secondary": "#9D3789",
"tertiary": "#9D3789"
},
"email": {
"footer": {
"markdown": "**Bold** and _italic_ with a [link](https://www.courier.com)",
"social": {
"facebook": {
"url": "https://www.facebook.com/example"
},
"instagram": {
"url": "https://www.instagram.com/example"
},
"linkedin": {
"url": "https://www.linkedin.com/example"
},
"medium": {
"url": "https://www.medium.com/example"
},
"twitter": {
"url": "https://www.twitter.com/example"
}
}
},
"header": {
"barColor": "#9D3789",
"logo": {
"href": "https://www.courier.com",
"image": "https://www.courier.com/logo.png"
}
}
}
},
"updated": 1591753605265,
"snippets": {
"items": [
{}
]
},
"version": "2020-06-19T18:51:36.083Z"
}
{
"message": "Error Message",
"type": "invalid_request_error"
}
{
"message": "Limit Exceeded",
"type": "authorization_error"
}
{
"message": "Already Exists",
"type": "invalid_request_error"
}
Was this helpful?