Create a card group

Changed on
post/v2/card-groups

Request

  • Base URL
    https://api.slash.com
  • URL
    https://api.slash.com/v2/card-groups
  • Auth
    API key in header X-API-Key

Headers

X-Idempotency-Keystring required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Request body

namestring required

Example request

{
  "controls": {
    "limit": {
      "amount": {
        "amount": 500000,
        "currency": "USD"
      },
      "period": "monthly"
    },
    "transactionLimit": {
      "amount": 250000,
      "currency": "USD"
    },
    "merchantCategoryCodes": {
      "mode": "block",
      "values": [
        "7995"
      ]
    }
  }
}

Response

The card group.

idstring required

Card group id with the card_group_ prefix.

namestring required
status'active' | 'archived' required
createdAtstring date-time required

Example response

{
  "id": "card_group_2rj4l7hmrrrcv",
  "name": "Marketing",
  "controls": {
    "limit": {
      "amount": {
        "amount": 500000,
        "currency": "USD"
      },
      "period": "monthly"
    },
    "transactionLimit": {
      "amount": 250000,
      "currency": "USD"
    },
    "merchantCategoryCodes": {
      "mode": "block",
      "values": [
        "7995"
      ]
    }
  }
}

Changes