API · Create group

API v1

POST /api/v1/collect/set/group

What it does#

Create group.

Authentication#

Host: https://app.tilopay.com. Requires the API bearer token in Authorization: Bearer <token> and the integration key in the body (key).

Get the API token.

Parameters#

keystringrequired#

Integration key.

namestringrequired#

Group name.

currencystringrequired#

ISO 4217 currency.

amountstringrequired#

Default amount, text with 2 decimal places.

Request example#

<api_key> is the placeholder for your integration key.

{
  "key": "<api_key>",
  "currency": "USD",
  "amount": "100.00",
  "name": "Grupo Name"
}

Response#

type is "200". id identifies the created group.

typestring#

type.

errorsunknown#

errors.

idunknown#

id.

{
  "type": "200",
  "errors": "",
  "id": 10
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "200"
    },
    "errors": {
      "type": "string"
    },
    "id": {
      "type": "integer"
    }
  }
}

Last verified: 2026-10-20

View as raw Markdown