---
title: "Activate a testmode personalization design"
method: POST
path: "/v1/test_helpers/issuing/personalization_designs/{personalization_design}/activate"
---

# Activate a testmode personalization design

`POST /v1/test_helpers/issuing/personalization_designs/{personalization_design}/activate`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/test_helpers/issuing/personalization_designs/{personalization_design}/activate`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Updates the `status` of the specified testmode personalization design object to `active`.

## Path parameters

- `personalization_design` string, required

## Response `200`

Successful response.

- IssuingPersonalizationDesign: A Personalization Design is a logical grouping of a Physical Bundle, card logo, and carrier text that represents a product line.
  - `card_logo` union: The file for the card logo to use with physical bundles that support card logos. Must have a `purpose` value of `issuing_logo`. Image must be in PNG format with dimensions of 1000px by 200px. It must be a binary (black and white) image containing a black logo on a white background. We don't accept grayscale.
    - string
    - File: This object represents files hosted on Stripe's servers. You can upload files with the [create file](https://docs.stripe.com/api#create_file) request (for example, when uploading dispute evidence). Stripe also creates files independently (for example, the results of a [Sigma scheduled query](#scheduled_queries)). Related guide: [File upload guide](https://docs.stripe.com/file-upload)
      - `created` integer, required: Time at which the object was created. Measured in seconds since the Unix epoch.
      - `expires_at` integer, nullable: The file expires and isn't available at this time in epoch seconds.
      - `filename` string, nullable: The suitable name for saving the file to a filesystem.
      - `id` string, required: Unique identifier for the object.
      - `links` object, nullable: A list of [file links](https://docs.stripe.com/api#file_links) that point at this file.
        - `data` FileLink[], required: Details about each object.
          - `created` integer, required: Time at which the object was created. Measured in seconds since the Unix epoch.
          - `expired` boolean, required: Returns if the link is already expired.
          - `expires_at` integer, nullable: Time that the link expires.
          - `file` union, required: The file object this link points to.
            - string
            - File (recursive)
          - `id` string, required: Unique identifier for the object.
          - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
          - `metadata` object, required: Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
          - `object` 'file_link', required: String representing the object's type. Objects of the same type share the same value.
          - `url` string, nullable: The publicly accessible URL to download the file.
        - `has_more` boolean, required: True if this list has another page of items after this one that can be fetched.
        - `object` 'list', required: String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
        - `url` string, required: The URL where this list can be accessed.
      - `object` 'file', required: String representing the object's type. Objects of the same type share the same value.
      - `purpose` 'account_requirement' | 'additional_verification' | 'business_icon' | 'business_logo' | 'customer_signature' | 'dispute_evidence' | 'document_provider_identity_document' | 'finance_report_run' | 'financial_account_statement' | 'identity_document' | 'identity_document_downloadable' | 'issuing_regulatory_reporting' | 'pci_document' | 'platform_terms_of_service' | 'selfie' | 'sigma_scheduled_query' | 'tax_document_user_upload' | 'terminal_android_apk' | 'terminal_reader_splashscreen' | 'terminal_wifi_certificate' | 'terminal_wifi_private_key', required: The [purpose](https://docs.stripe.com/file-upload#uploading-a-file) of the uploaded file.
      - `size` integer, required: The size of the file object in bytes.
      - `title` string, nullable: A suitable title for the document.
      - `type` string, nullable: The returned file type (for example, `csv`, `pdf`, `jpg`, or `png`).
      - `url` string, nullable: Use your live secret API key to download the file from this URL.
  - `carrier_text` IssuingPersonalizationDesignCarrierText
    - `footer_body` string, nullable: The footer body text of the carrier letter.
    - `footer_title` string, nullable: The footer title text of the carrier letter.
    - `header_body` string, nullable: The header body text of the carrier letter.
    - `header_title` string, nullable: The header title text of the carrier letter.
  - `created` integer, required: Time at which the object was created. Measured in seconds since the Unix epoch.
  - `id` string, required: Unique identifier for the object.
  - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `lookup_key` string, nullable: A lookup key used to retrieve personalization designs dynamically from a static string. This may be up to 200 characters.
  - `metadata` object, required: Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
  - `name` string, nullable: Friendly display name.
  - `object` 'issuing.personalization_design', required: String representing the object's type. Objects of the same type share the same value.
  - `physical_bundle` union, required: The physical bundle object belonging to this personalization design.
    - string
    - IssuingPhysicalBundle: A Physical Bundle represents the bundle of physical items - card stock, carrier letter, and envelope - that is shipped to a cardholder when you create a physical card.
      - `features` IssuingPhysicalBundleFeatures, required
        - `card_logo` 'optional' | 'required' | 'unsupported', required: The policy for how to use card logo images in a card design with this physical bundle.
        - `carrier_text` 'optional' | 'required' | 'unsupported', required: The policy for how to use carrier letter text in a card design with this physical bundle.
        - `second_line` 'optional' | 'required' | 'unsupported', required: The policy for how to use a second line on a card with this physical bundle.
      - `id` string, required: Unique identifier for the object.
      - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
      - `name` string, required: Friendly display name.
      - `object` 'issuing.physical_bundle', required: String representing the object's type. Objects of the same type share the same value.
      - `status` 'active' | 'inactive' | 'review', required: Whether this physical bundle can be used to create cards.
      - `type` 'custom' | 'standard', required: Whether this physical bundle is a standard Stripe offering or custom-made for you.
  - `preferences` IssuingPersonalizationDesignPreferences, required
    - `is_default` boolean, required: Whether we use this personalization design to create cards when one isn't specified. A connected account uses the Connect platform's default design if no personalization design is set as the default design.
    - `is_platform_default` boolean, nullable: Whether this personalization design is used to create cards when one is not specified and a default for this connected account does not exist.
  - `rejection_reasons` IssuingPersonalizationDesignRejectionReasons, required
    - `card_logo` string[], nullable: The reason(s) the card logo was rejected.
    - `carrier_text` string[], nullable: The reason(s) the carrier text was rejected.
  - `status` 'active' | 'inactive' | 'rejected' | 'review', required: Whether this personalization design can be used to create cards.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)