---
title: "Anexar um PDF externo ao boleto"
method: POST
path: "/brazil/boleto/onetime/external/upload-pdf"
tags: ["Boleto"]
---

# Anexar um PDF externo ao boleto

`POST /brazil/boleto/onetime/external/upload-pdf`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/brazil/boleto/onetime/external/upload-pdf`
- Auth: API key in header `x-api-key`

Armazena o PDF do boleto gerado pela sua organização e dispara a mensageria ao pagador. O arquivo é guardado no mesmo lugar do PDF gerado pela Toku, então o portal e os endpoints de download passam a devolvê-lo sem nenhuma outra chamada. Disponível apenas para Accounts configuradas para enviar o seu próprio PDF.

## Headers

- `x-account-key` string

## Request body

- ExternalBoletoPdfPayload
  - `id_transaction` string, required: Identificador da Transaction do boleto, devolvido na emissão.
  - `notify_payer` boolean: Quando `false`, o PDF é armazenado sem disparar a mensageria ao pagador.
  - `pdf_url` string, uri, required: URL https de onde a Toku baixa o PDF. Deve apontar para um endereço público.

## Response `204`

Successful Response

## Other responses

- `403`: Requisição sem uma API key válida.
- `413`: O arquivo é maior do que o tamanho aceito.
- `422`: A Transaction indicada não existe, não é um boleto ou não pertence à sua organização, a Account não está configurada para enviar o seu próprio PDF, ou a URL não entrega um PDF seguro a partir de um endereço público.
- `502`: Não foi possível baixar o arquivo na origem.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/brazil/boleto/onetime/external/upload-pdf/post.md)

---

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