---
title: "Create a payer theme associated with a creditor"
method: POST
path: "/branding/payer_themes"
tags: ["Payer Theme"]
---

# Create a payer theme associated with a creditor

`POST /branding/payer_themes`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/branding/payer_themes`
- Auth: HTTP bearer

Creates a new payer theme associated with a creditor. If a creditor already has payer themes, this will update the existing payer theme linked to the creditor.

<p class="restricted-notice"><strong>Restricted</strong>: This endpoint is restricted to GoCardless Embed customers. Please [contact us](https://forms.gocardless.com/l/305971/2023-01-25/535t8n){:target="_blank"} if you are interested in using this product.</p>

## Headers

- `GoCardless-Version` string, required

## Request body

- object
  - `payer_themes` object
    - `header_background_colour` string: Colour for header background (hexcode)
    - `link_text_colour` string: Colour for text links (hexcode)
    - `button_background_colour` string: Colour for buttons background (hexcode)
    - `content_box_border_colour` string: Colour for content box border (hexcode)
    - `links` object
      - `creditor` string, nullable: ID of the creditor the payer theme belongs to

## Response `201`

Resource created successfully

- PayerThemeSingleResourceResponse
  - `payer_themes` PayerTheme: Custom colour themes for payment pages and customer notifications.
    - `id` string: Unique identifier, beginning with "PTH".

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

[API](https://skmtc.dev/gocardless/apis/gocardless-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-api/revisions/4dd3dae45364?raw)