Create Card

post

https://api.cloud.mbanq.com/v1/cards

Before you begin: Ensure a card product has been configured for your tenant. See Create Card Product for setup instructions.

Use this API to issue and instantly activate a new card for a client — whether that's a debit card tied to a savings account or a credit card linked to a credit account. Once created, the card is automatically activated and ready for immediate use.

How it works

Mbanq sets up the card product on your behalf. To create a card, simply supply the cardProductId that corresponds to the type of card you want to issue.

Card types

Debit Card — Link the card to an existing savings account, or create a new one first using Create Savings Account.
Credit Card — Link the card to an existing credit account, or create a new one first using Create Credit Account.

You can also pass a userId to associate the card with a specific user within the client's account.

What to expect

A successful response confirms that the card has been created and activated. No additional activation step is required.

For a full overview of card capabilities, see the Card Features guide.

Webhooks

The following webhook events are triggered once the card is ordered and activated:

Event	Webhook Reference
Order Card	Order Card
Activate Card	Activate Card

Body Params

The request body must match one of the following requests depending on the card type:

How to Use

Provide either savingsAccountId (for an existing account) or savingsProductId (to create a new account for the client).
productId is required and refers to the card product configuration.
clientId is required if creating a new account.
Optionally, associate the card with a specific user using userId.

Example Scenarios

Link to existing account: Provide savingsAccountId, productId, and optionally userId.
Create new account: Provide savingsProductId, clientId, and productId.

productId

integer

required

Defaults to 1

The ID of the card product to use. This must be pre-configured. Pattern: ^\d+$ Example: 1

savingsAccountId

integer

required

Defaults to 18

The ID of the existing savings account to link the debit card. Conditional Requirement: savingsProductId and clientId are not required if savingsAccountId is provided. Pattern: ^\d+$ Example: 18

userId

integer

The ID of the user within the client account to associate the card. Pattern: ^\d+$ Example: 7

clientId

integer

The ID of the client. Required if creating a new account with savingsProductId. Pattern: ^\d+$ Example: 111

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Responses

How to Use

Example Scenarios

200The card is created and activated successfully.

400The request failed validation. Common causes include invalid product selection or missing account identifiers.

401Authentication credentials were missing or incorrect.

403The authenticated user does not have permission to manage cards.

404The request fails if the specified account or product is not found.