Courier

Courier Brands API

The Brands API from Courier — 2 operation(s) for brands.

GitHub OpenAPI

Operations 5

POST /brands Create a new brand #
GET /brands List brands #
GET /brands/{brand_id} Get a brand #
PUT /brands/{brand_id} Replace a brand #
DELETE /brands/{brand_id} Delete a brand #

Documentation

📖
Documentation
https://www.courier.com/docs/reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/courier/refs/heads/main/openapi/courier-brands-api-openapi.yml

Other Resources

🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/courier/refs/heads/main/graphql/courier-graphql.md

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/courier-brands-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

courier-brands-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Courier Audiences Brands API
  description: The Courier REST API.
  version: '1.0'
servers:
- url: https://api.courier.com
  description: Production
tags:
- name: Brands
paths:
  /brands:
    post:
      operationId: brands_create
      tags:
      - Brands
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Brand'
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
        '402':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '409':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlreadyExists'
      summary: Create a new brand
      security:
      - BearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BrandParameters'
    get:
      description: Get the list of brands.
      operationId: brands_list
      tags:
      - Brands
      parameters:
      - name: cursor
        in: query
        description: A unique identifier that allows for fetching the next set of brands.
        required: false
        schema:
          type:
          - string
          - 'null'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandsResponse'
      summary: List brands
      security:
      - BearerAuth: []
  /brands/{brand_id}:
    get:
      description: Fetch a specific brand by brand ID.
      operationId: brands_get
      tags:
      - Brands
      parameters:
      - name: brand_id
        in: path
        description: A unique identifier associated with the brand you wish to retrieve.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Brand'
      summary: Get a brand
      security:
      - BearerAuth: []
    put:
      description: Replace an existing brand with the supplied values.
      operationId: brands_replace
      tags:
      - Brands
      parameters:
      - name: brand_id
        in: path
        description: A unique identifier associated with the brand you wish to update.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Brand'
      summary: Replace a brand
      security:
      - BearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: The name of the brand.
                settings:
                  $ref: '#/components/schemas/BrandSettings'
                snippets:
                  $ref: '#/components/schemas/BrandSnippets'
              required:
              - name
    delete:
      description: Delete a brand by brand ID.
      operationId: brands_delete
      tags:
      - Brands
      parameters:
      - name: brand_id
        in: path
        description: A unique identifier associated with the brand you wish to retrieve.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: ''
        '409':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Conflict'
      summary: Delete a brand
      security:
      - BearerAuth: []
components:
  schemas:
    BrandTemplateOverride:
      title: BrandTemplateOverride
      type: object
      properties:
        mjml:
          $ref: '#/components/schemas/BrandTemplate'
        footerBackgroundColor:
          type:
          - string
          - 'null'
        footerFullWidth:
          type:
          - boolean
          - 'null'
      required:
      - mjml
      allOf:
      - $ref: '#/components/schemas/BrandTemplate'
    BrandParameters:
      title: BrandParameters
      type: object
      properties:
        id:
          type:
          - string
          - 'null'
        name:
          type: string
        settings:
          $ref: '#/components/schemas/BrandSettings'
        snippets:
          $ref: '#/components/schemas/BrandSnippets'
      required:
      - name
    EmailHead:
      title: EmailHead
      type: object
      properties:
        inheritDefault:
          type: boolean
        content:
          type:
          - string
          - 'null'
      required:
      - inheritDefault
    PaymentRequired:
      title: PaymentRequired
      type: object
      properties:
        type:
          type: string
          enum:
          - authorization_error
      required:
      - type
      allOf:
      - $ref: '#/components/schemas/BaseError'
    AlreadyExists:
      title: AlreadyExists
      type: object
      properties:
        type:
          type: string
          enum:
          - invalid_request_error
      required:
      - type
      allOf:
      - $ref: '#/components/schemas/BaseError'
    BadRequest:
      title: BadRequest
      type: object
      properties:
        type:
          type: string
          enum:
          - invalid_request_error
      required:
      - type
      allOf:
      - $ref: '#/components/schemas/BaseError'
    Brand:
      title: Brand
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        published:
          type:
          - integer
          - 'null'
          format: int64
        created:
          type: integer
          format: int64
        updated:
          type: integer
          format: int64
        settings:
          $ref: '#/components/schemas/BrandSettings'
        snippets:
          $ref: '#/components/schemas/BrandSnippets'
        version:
          type:
          - string
          - 'null'
      required:
      - id
      - name
      - created
      - updated
    BrandTemplate:
      title: BrandTemplate
      type: object
      properties:
        backgroundColor:
          type:
          - string
          - 'null'
        blocksBackgroundColor:
          type:
          - string
          - 'null'
        enabled:
          type: boolean
        footer:
          type:
          - string
          - 'null'
        head:
          type:
          - string
          - 'null'
        header:
          type:
          - string
          - 'null'
        width:
          type:
          - string
          - 'null'
      required:
      - enabled
    Conflict:
      title: Conflict
      type: object
      properties:
        type:
          type: string
          enum:
          - invalid_request_error
      required:
      - type
      allOf:
      - $ref: '#/components/schemas/BaseError'
    Icons:
      title: Icons
      type: object
      properties:
        bell:
          type:
          - string
          - 'null'
        message:
          type:
          - string
          - 'null'
    BaseError:
      title: BaseError
      type: object
      properties:
        message:
          type: string
          description: A message describing the error that occurred.
      required:
      - message
    BrandSettings:
      title: BrandSettings
      type: object
      properties:
        colors:
          $ref: '#/components/schemas/BrandColors'
        email:
          $ref: '#/components/schemas/BrandSettingsEmail'
        inapp:
          $ref: '#/components/schemas/BrandSettingsInApp'
    Paging:
      title: Paging
      type: object
      properties:
        cursor:
          type:
          - string
          - 'null'
        more:
          type: boolean
      required:
      - more
    InAppPlacement:
      title: InAppPlacement
      type: string
      enum:
      - top
      - bottom
      - left
      - right
    EmailHeader:
      title: EmailHeader
      type: object
      properties:
        inheritDefault:
          type:
          - boolean
          - 'null'
        barColor:
          type:
          - string
          - 'null'
        logo:
          $ref: '#/components/schemas/Logo'
      required:
      - logo
    Logo:
      title: Logo
      type: object
      properties:
        href:
          type:
          - string
          - 'null'
        image:
          type:
          - string
          - 'null'
    BrandSnippet:
      title: BrandSnippet
      type: object
      properties:
        name:
          type: string
        value:
          type: string
      required:
      - name
      - value
    BrandsResponse:
      title: BrandsResponse
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        results:
          type: array
          items:
            $ref: '#/components/schemas/Brand'
      required:
      - paging
      - results
    BrandSnippets:
      title: BrandSnippets
      type: object
      properties:
        items:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/BrandSnippet'
    EmailFooter:
      title: EmailFooter
      type: object
      properties:
        content:
          type:
          - string
          - 'null'
        inheritDefault:
          type:
          - boolean
          - 'null'
    BrandSettingsEmail:
      title: BrandSettingsEmail
      type: object
      properties:
        templateOverride:
          $ref: '#/components/schemas/BrandTemplateOverride'
        head:
          $ref: '#/components/schemas/EmailHead'
        footer:
          $ref: '#/components/schemas/EmailFooter'
        header:
          $ref: '#/components/schemas/EmailHeader'
    BrandColors:
      title: BrandColors
      type: object
      properties:
        primary:
          type: string
        secondary:
          type: string
      additionalProperties:
        type: string
    BrandSettingsInApp:
      title: BrandSettingsInApp
      type: object
      properties:
        borderRadius:
          type:
          - string
          - 'null'
        disableMessageIcon:
          type:
          - boolean
          - 'null'
        fontFamily:
          type:
          - string
          - 'null'
        placement:
          $ref: '#/components/schemas/InAppPlacement'
        widgetBackground:
          $ref: '#/components/schemas/WidgetBackground'
        colors:
          $ref: '#/components/schemas/BrandColors'
        icons:
          $ref: '#/components/schemas/Icons'
      required:
      - widgetBackground
      - colors
      - icons
    WidgetBackground:
      title: WidgetBackground
      type: object
      properties:
        topColor:
          type:
          - string
          - 'null'
        bottomColor:
          type:
          - string
          - 'null'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer