Sign in

v50

latestOpenAPI 3.0.1raw.githubusercontent.com2026-07-169377194.1 KB
Agreements

Create an agreement

post/v1/api/accounts/{accountId}/agreements

Path parameters

accountIdinteger required

Gateway account ID

Request body

descriptionstring required
referencestring required
user_identifierstring

Example request

{
  "description": "Description for the paying user describing the purpose of the agreement",
  "reference": "Service agreement reference",
  "user_identifier": "reference for the paying user"
}

Response

OK

agreement_idstring
created_datestring date-time
descriptionstring
liveboolean
referencestring
service_idstring
user_identifierstring

Example response

{
  "agreement_id": "iaouobo39hiv0m2560q45j3p04",
  "created_date": "2022-06-27T13:07:57.58Z",
  "description": "Description for the paying user describing the purpose of the agreement",
  "reference": "Service agreement reference",
  "service_id": "Service external ID",
  "user_identifier": "reference for the paying user"
}