> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.thepennyinc.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.thepennyinc.com/_mcp/server.

# card_product.created

POST 

Sent when a `card_product.created` event occurs.

Reference: https://docs.thepennyinc.com/banking/api-reference/webhook-payloads/card-product/card-product-created-webhook

## Request

### Payload

- `event_id` (string, required) — Penny's unique identifier for this notification event.
- `business_id` (string, required) — The business the event belongs to. When the event originated from a different business, this contains the originating business.
- `type` ("card_product.created", required) — The notification event type. This identifies the specific occurrence represented by the event and determines how its data should be interpreted.
- `category` ("object", required) — The category of the event payload. This groups related notification event types and describes the general kind of data contained in ``data``.
- `schema_version` ("1.0", required) — The version of the JSON notification event schema used to encode this webhook payload.
- `event_time` (datetime, required) — The date and time Penny generated the notification event.
- `occurrence_time` (datetime, required) — The date and time the underlying occurrence represented by this notification event took place.
- `data` (WebhooksCardProductCreatedWebhookPayloadContentApplicationJsonSchemaData, required) — A notification about a domain object being created, updated, or deleted.

## Types

### WebhooksCardProductCreatedWebhookPayloadContentApplicationJsonSchemaData

A notification about a domain object being created, updated, or deleted.

- `operation` (enum, required) — The change that produced this event: 'created', 'updated', or 'deleted'.
  - Allowed values: `created`, `updated`, `deleted`
- `subject` (ObjectReferenceResponse, required) — The object this event concerns.
- `category` ("object", optional, default: object) — Identifies this payload as an object change.
- `object` (VirtualCardProductWebhookPayload, optional) — A virtual card product, as delivered in webhook event payloads.
- `previous_attributes` (map from string to any, optional, nullable) — The object's attributes before this change, if included.

### ObjectReferenceResponse

A pointer to the object this event concerns.

- `object_type` (string, required) — The kind of object this event concerns.
- `object_id` (string, required) — The unique identifier of the object this event concerns.
- `version` (integer, optional, nullable) — The object's version at the time of this event, if known.
- `stage` (integer, optional, nullable) — The object's lifecycle stage at the time of this event, if applicable.

### VirtualCardProductWebhookPayload

A virtual card product, as delivered in webhook event payloads.

- `card_product_id` (string, required) — Penny's unique identifier for this card product.
- `version` (integer, required) — A number that increases each time this product's details change. Use it to confirm you are looking at the latest information.
- `version_time` (datetime, required) — The date and time this product's details were last changed.
- `business_id` (string, required) — The business this product belongs to.
- `program_id` (string, required) — The program this product is offered under.
- `usage_type` (enum, required) — The usage type permitted for cards issued under this product.
  - Allowed values: `single_use`, `single_reload`, `reloadable`
- `expiration_date_config` (ExpirationDateConfigResponse, required) — The rules used to compute the expiration date of cards issued under this product.
- `status` (enum, required) — This product's current lifecycle status.
  - Allowed values: `draft`, `active`, `suspended`, `archived`
- `alias` (string, required) — A human-readable name for this product.
- `active` (boolean, required) — Whether this product is currently active for card issuance.
- `archived` (boolean, required) — Whether this product has been archived. Archived products can no longer issue cards.
- `description` (string, optional, nullable) — An extended description of this product.
- `form_factor` (enum, optional, default: virtual) — The form of cards issued under this product.
  - Allowed values: `virtual`

### ExpirationDateConfigResponse

The rules used to compute a card's expiration date when it is issued.

- `default_expiration_months` (integer, required) — The number of months a card is valid for by default, from its issue date.
- `max_expiration_months` (integer, optional, nullable) — The longest a card issued under this product may be valid for, in months, if a limit is set.