Create a new program

Request

Header Params

Content-Type

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {{access_token}}

Body Params application/json

type

string

required

partner_product

string

required

metadata

object

required

Example

{
    "type": "VIRTUAL",
    "partner_product": "KOBBLE_DEBIT_1",
    "metadata": {}
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/customers/v1/card-programs' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "VIRTUAL",
    "partner_product": "KOBBLE_DEBIT_1",
    "metadata": {}
}'

Responses

🟢200OK

application/json

Body

A program object representing a card program.

id

string <uuid>

required

The unique identifier of the program.

type

enum<string>

required

The type of program (virtual or physical).

Allowed values:

VIRTUALPHYSICAL

created_at

string <date-time>

required

The date and time the program was created.

updated_at

string <date-time>

required

The date and time the program was last updated.

status

enum<string>

required

The current status of the program.

Allowed values:

ACTIVEINACTIVE

partner_product

enum<string>

required

The partner product associated with the program.

Allowed value:

KOBBLE_DEBIT_1

metadata

object

required

Metadata specific to the program.

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": {}
}