Scope: accounting:payments.write https://api.alladdin.com/api/v2/payments

Creates a new payment movement in your account. Use type: "payment" for outgoing money (money you send out, e.g. paying a supplier) and type: "collection" for incoming money (money you receive, e.g. collecting from a customer).
The response returns the new payment movement id.

Request body

object type string required

Movement direction: "payment" for outgoing money, "collection" for incoming money

Enum: payment collection amount string required

Absolute payment amount as decimal string (must be greater than zero)

date string<date> required

Payment date in ISO 8601 format (YYYY-MM-DD)

bank_account_id string | null optional

Treasury account identifier

contact_id string | null optional

Contact identifier

description string | null optional

Payment description

Request

import requests

url = "https://api.alladdin.com/api/v2/payments"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "type": "payment",
    "amount": "1500.50",
    "date": "2026-05-13",
    "bank_account_id": "string",
    "contact_id": "string",
    "description": "string"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201 Payment created application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json

Next →Update a payment →