---
title: "Create a logo associated with a creditor"
method: POST
path: "/branding/logos"
tags: ["Logo"]
---

# Create a logo associated with a creditor

`POST /branding/logos`

## Request

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

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

We support JPG and PNG formats. Your logo will be scaled to a maximum of 300px by 40px. For more guidance on how to upload logos that will look
great across your customer payment page and notification emails see [here](https://docs.gocardless.com/docs/gc-embed/setting-up-branding#tips-for-uploading-your-logo).

<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
  - `logos` object
    - `image` string, required: Base64 encoded string.
    - `links` object
      - `creditor` string: ID of the creditor the logo belongs to

## Response `201`

Resource created successfully

- LogoSingleResourceResponse
  - `logos` Logo: Logos are image uploads that, when associated with a creditor, are shown on the [billing request flow](https://docs.gocardless.com/docs/api-reference/billing-request-flow) payment pages.
    - `id` string, required: Unique identifier, beginning with "LO".

## 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)