---
title: "Create Card Image"
method: POST
path: "/cards/images"
tags: ["Cards"]
---

# Create Card Image

`POST /cards/images`

Create a card image entity. Note that this does not include the image data itself. You can upload the image data via a subsequent uploadCardImageData request using the ID created here.

## Headers

- `Idempotency-Key` string

## Request body

- CreateCardImageRequest
  - `card_product_id` string, uuid, required — The unique identifier of a cards product
  - `customer_id` string, uuid, required — The unique identifier of a customer

## Response `201`

Card image entity created

- CardImageDetails
  - `card_product_id` string, uuid, required — The unique identifier of a cards product
  - `customer_id` string, uuid, required — The unique identifier of a customer
  - `id` string, uuid, required — The unique identifier of a card image
  - `rejection_memo` string
  - `rejection_reason` 'BRANDED' | 'COPYRIGHT' | 'INAPPROPRIATE' | 'OTHER' | 'PROMOTIONAL' | 'TRADEMARK' — The category of reason that a card image was rejected
  - `status` 'APPROVED' | 'NOT_UPLOADED' | 'REJECTED' | 'UNREVIEWED', required — The status of a custom card image

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/versions/b0d812e6cdd0/schema)