---
title: "Create a delayed route"
method: POST
path: "/payments/{paymentId}/routes"
tags: ["Delayed Routing API"]
---

# Create a delayed route

`POST /payments/{paymentId}/routes`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/payments/{paymentId}/routes`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `payments.write`

Create a route for a specific payment. The routed amount is credited to the account of your customer.

> 🔑 Access with
>
> [API key](/reference/authentication)
>
> [Advanced access token with **payments.write**](/reference/authentication)
>
> [OAuth access with **payments.write**](/reference/authentication)

## Request body

- object: Payload to create a new delayed route for a payment.
  - `amount` object, required: The amount to be routed.
    - `currency` string, required: A three-character ISO 4217 currency code.
    - `value` string, required: A string containing an exact monetary amount in the given currency.
  - `destination` object, required: The destination of the route.
    - `type` string, required: The type of destination. Currently only the destination type `organization` is supported. Possible values: `organization`
    - `organizationId` string, required: Required for destination type `organization`. The ID of the connected organization the funds should be routed to.
  - `description` string: Description shown in reports.

## Response `201`

The route object.

- object
  - `resource` string, required: Indicates the response contains a route object. Will always contain the string `route` for this endpoint.
  - `id` string, required: The identifier uniquely referring to this route. Mollie assigns this identifier at route creation time. Mollie will always refer to the route by this ID. Example: `crt_dyARQ3JzCgtPDhU2Pbq3J`.
  - `paymentId` string, required: The unique identifier of the payment. For example: `tr_5B8cwPMGnU6qLbRvo7qEZo`. The full payment object can be retrieved via the payment URL in the `_links` object.
  - `amount` object, required: The amount of the route. That amount that will be routed to the specified destination.
    - `currency` string, required: A three-character ISO 4217 currency code.
    - `value` string, required: A string containing an exact monetary amount in the given currency.
  - `description` string: The description of the route. This description is shown in the reports.
  - `destination` object, required: The destination of the route.
    - `type` string, required: The type of destination. Currently only the destination type `organization` is supported. Possible values: `organization`
    - `organizationId` string, required: Required for destination type `organization`. The ID of the connected organization the funds should be routed to.
  - `testmode` boolean, nullable: Whether to create the entity in test mode or live mode. Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting `testmode` to `true`.
  - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
    - `self` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `payment` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `404`: No entity with this ID exists.
- `429`: Rate Limit has been reached.

---

[API](https://skmtc.dev/mollie/apis/accepting-payments.md) - [All operations](https://skmtc.dev/mollie/apis/accepting-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/accepting-payments/revisions/64fc448adebb?raw)