Update your settings - Infinity API

POST

/

account

/

settings

Update your settings

curl --request POST \
  --url https://sandbox-api.infinityapp.in/v1/account/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "id": "account_5u9q6vhek42vemdc",
  "company_name": "Acme Ltd",
  "email": "ops@acme.com",
  "contact": {
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+442071234567"
  },
  "registered_address": "1 High St, London",
  "status": "active",
  "settings": {
    "fee_bearer": "account",
    "hold_expiry_days": 30
  },
  "created_at": "2026-09-01T09:00:00Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

Authorizations

Authorization

string

header

required

Your secret key: sk_test_… on the sandbox host, sk_live_… on live. A key on the wrong host gets a 401 wrong_environment. Keys are secret. Keep them on your server, never in a browser or app.

Body

application/json

fee_bearer

enum<string>

Available options:

account,

payee

hold_expiry_days

enum<integer>

Available options:

30,

60,

90

Response

The account with its new settings.

id

string

required

Example:

"account_5u9q6vhek42vemdc"

company_name

string | null

required

null for an individual account.

Example:

"Acme Ltd"

email

string

required

The login email.

Example:

"ops@acme.com"

contact

object

required

Show child attributes

registered_address

string | null

required

Free text, as given at onboarding.

Example:

"1 High St, London"

status

enum<string>

required

Available options:

active,

inactive

settings

object

required

Show child attributes

created_at

string<date-time>

required

Example:

"2026-09-01T09:00:00Z"

Update your settings

curl --request POST \
  --url https://sandbox-api.infinityapp.in/v1/account/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "id": "account_5u9q6vhek42vemdc",
  "company_name": "Acme Ltd",
  "email": "ops@acme.com",
  "contact": {
    "first_name": "Jane",
    "last_name": "Doe",
    "phone": "+442071234567"
  },
  "registered_address": "1 High St, London",
  "status": "active",
  "settings": {
    "fee_bearer": "account",
    "hold_expiry_days": 30
  },
  "created_at": "2026-09-01T09:00:00Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}