increase-test
POST/digital_card_profiles

Create a Digital Card Profile

Creates a Digital Card Profile with artwork and metadata for how a card appears in digital wallet apps. Provide the required descriptions, issuer name, and image file identifiers; contact details and text color are optional. Use text_color to customize the card's text color.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

9 body fields

Digital Card Profile details. The description, issuer name, card description, background image file identifier, and app icon file identifier are required.

app_icon_file_idstringrequired
The identifier of the File containing the card's icon image.
background_image_file_idstringrequired
The identifier of the File containing the card's front image.
card_descriptionstringrequired
A user-facing description for the card itself.
contact_emailstringoptional
An email address the user can contact to receive support for their card.
contact_phonestringoptional
A phone number the user can contact to receive support for their card.
contact_websitestringoptional
A website the user can visit to view and receive support for their card.
descriptionstringrequired
A description you can use to identify the Card Profile.
issuer_namestringrequired
A user-facing description for whoever is issuing the card.
text_colorobjectoptional
The Card's text color, specified as an RGB triple. The default is white.

3 status codes
200Returns the created Digital Card Profile, including its identifier, status, artwork file identifiers, contact details, and text color.
app_icon_file_idstringrequired
The identifier of the File containing the card's icon image.
background_image_file_idstringrequired
The identifier of the File containing the card's front image.
card_descriptionstringrequired
A user-facing description for the card itself.
contact_emailstringrequired
An email address the user can contact to receive support for their card.
contact_phonestringrequired
A phone number the user can contact to receive support for their card.
contact_websitestringrequired
A website the user can visit to view and receive support for their card.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Digital Card Profile was created.
descriptionstringrequired
A description you can use to identify the Card Profile.
idstringrequired
The Card Profile identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
issuer_namestringrequired
A user-facing description for whoever is issuing the card.
statusstringrequired
The status of the Card Profile.
Allowed:pendingrejectedactivearchived
text_colorobjectrequired
The Card's text color, specified as an RGB triple.
typestringrequired
A constant representing the object's type. For this resource it will always be `digital_card_profile`.
Allowed:digital_card_profile
4XXReturned when the request results in a client error.
5XXReturned when the server encounters an error processing the request.

Error handling

description, issuer_name, card_description, background_image_file_id, and app_icon_file_id are required. description must be 1–200 characters, issuer_name and card_description must be 1–32 characters, and a provided contact_email must be a valid email address of 1–32 characters.