Skip to main content
POST
/
budgets
/
{budgetId}
/
direct-debits
Create a direct debit
curl --request POST \
  --url https://api.equalsmoney.com/v2/budgets/{budgetId}/direct-debits \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reference": "fre4r5tg",
  "processingDate": "2025-01-15",
  "priority": 2,
  "originator": {
    "id": "123456",
    "accountName": "Netflix Inc",
    "address": {
      "addressType": "ADDR",
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "countryCode": "GB"
    }
  }
}
'
{
  "id": "775596ae-2624-40af-a9dc-9756110a4a03",
  "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
  "reference": "fre4r5tg",
  "status": "ACTIVE",
  "priority": 2,
  "originator": {
    "id": "123456",
    "accountName": "Netflix Inc",
    "address": {
      "addressType": "ADDR",
      "addressLine": "Vintners Place, 68, Upper Thames Street",
      "city": "London",
      "postcode": "EC4V 3BJ",
      "countryCode": "GB"
    }
  },
  "createdAt": "2019-08-24T14:15:22Z"
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
budgetId
string<uuid>
required

The ID of the budget to work with.

Maximum string length: 36
Example:

"775596ae-2624-40af-a9dc-9756110a4a03"

Query Parameters

​
accountId
string
required

The ID of the account to work with.

Example:

"F50091"

Body

application/json

Body

​
reference
string
required

The direct debit reference, which may be set by the originator.

Required string length: 1 - 18
Example:

"fre4r5tg"

​
priority
integer
required

The payment priority when there are insufficient funds.

Required range: 1 <= x <= 10
Example:

2

​
originator
object
required
​
processingDate
string

The processing date of the direct debit.

Example:

"2025-01-15"

Response

201 - application/json

Created

​
id
string<uuid>
required

The unique identifier of the direct debit.

Example:

"775596ae-2624-40af-a9dc-9756110a4a03"

​
budgetId
string<uuid>
required

The ID of the budget to work with.

Maximum string length: 36
Example:

"775596ae-2624-40af-a9dc-9756110a4a03"

​
reference
string
required

The direct debit reference, which may be set by the originator.

Example:

"fre4r5tg"

​
status
enum<string>
required

The status of the direct debit.

Available options:
ACTIVE,
CANCELLED
Example:

"ACTIVE"

​
priority
integer
required

The payment priority when there are insufficient funds.

Required range: 1 <= x <= 10
Example:

2

​
originator
object
required
​
createdAt
string<date-time>
required

The date the Resource was initially created. ISO 8601 format without milliseconds.