Create a new program

POST

/customers/v1/card-programs

Create a new card program. Kobble-performed operation. This endpoint requires the administrator/write scope, which is reserved for Kobble-internal credentials and is not granted to client API credentials — requesting it at the token endpoint will be rejected. Card programs are provisioned for you by Kobble: contact your Kobble representative to have one created for your account, then use the returned program id as program_id when issuing cards. A program must exist before any card can be created.

Request

Header Params

Body Params application/json

Example

{
    "type": "VIRTUAL",
    "partner_product": "KOBBLE_DEBIT_1",
    "metadata": {
        "parent_account_id": "123456",
        "product_id": "9876"
    },
    "owner": "a30595d9-de0a-42ae-b3f3-55643abd2eb8"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/customers/v1/card-programs' \
--header 'x-client-id;' \
--header 'Content-Type: application/json' \
--data '{
    "type": "VIRTUAL",
    "partner_product": "KOBBLE_DEBIT_1",
    "metadata": {
        "parent_account_id": "123456",
        "product_id": "9876"
    },
    "owner": "a30595d9-de0a-42ae-b3f3-55643abd2eb8"
}'

Responses

🟢201Created

application/json

Bodyapplication/json

Example

{
    "id": "1b8ecc17-4edd-4b74-ae4f-208aeb78f105",
    "type": "VIRTUAL",
    "created_at": "2025-01-13T21:53:38.206Z",
    "updated_at": "2025-01-13T21:53:38.206Z",
    "status": "ACTIVE",
    "partner_product": "KOBBLE_DEBIT_1",
    "metadata": {}
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Modified at 2026-08-05 04:06:11

Get all programs

Get program by ID