---
title: "Upload someone’s logo"
method: POST
path: "/v1/logos"
tags: ["People"]
---

# Upload someone’s logo

`POST /v1/logos`

## Request

- Base URL: `https://app.verygoodletter.co/api`
- URL: `https://app.verygoodletter.co/api/v1/logos`
- Auth: HTTP bearer

For a letter that prints each person’s company logo (their_logo): a logo file of your own, sent as base64 (PNG, JPEG, WebP or SVG, up to 3 MB). It’s trimmed and made ready to print. Give the id it comes back with as their logo when you add them. Or skip this and give their website, or a link to the picture.

Permission: **Read and write**.

## Request body

- object
  - `data` string, required: The logo file, base64 (a data: URL is fine too). PNG, JPEG, WebP or SVG, up to 3 MB.
  - `filename` string: Its name, for your own reference.

## Response `200`

What it did, as JSON, with the mode it ran in.

- Answer
  - `mode` 'sandbox' | 'live', required: Which the request ran in: the key’s.

## Other responses

- `400`: What was sent needs changing. The error says what.
- `401`: No key, or one that’s been revoked.
- `403`: The key’s permission isn’t enough: this needs Read and write.
- `429`: More than 120 requests in a minute.

---

[API](https://skmtc.dev/verygoodletter/apis/the-very-good-letter-company-api.md) · [All operations](https://skmtc.dev/verygoodletter/apis/the-very-good-letter-company-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verygoodletter/apis/the-very-good-letter-company-api/revisions/c735d65147f5?raw)