---
updatedAt: 2026-05-07T13:26:35.000Z
agentTools:
  siteIndex: https://developers.pismo.io/llms.txt
  projectIndex: https://developers.pismo.io/pismo-docs/llms.txt
---

# Add card to next scheduled embossing


Add card to next scheduled embossing. 

You can use this endpoint for On Demand embossing. For more information, refer to [Embossing rules](doc:physical-card-embossing#embossing-rules) > On Demand embossing and [Embossing flows](doc:physical-card-embossing#embossing-flow).

**IMPORTANT**: 
  * You should only call this endpoint **AFTER** the [Card can be added to next scheduled embossing](https://developers.pismo.io/events/docs/cards-embossing-card-ingress-1) event is received. This event is generated when a card is created and all necessary asynchronous PCI configuration is done.
  * This endpoint does **NOT** generate an event.

**Notes:**
  * To use this endpoint, request it with a [Jira ticket](doc:opening-a-service-desk-ticket) with type = Settings and ask to use *ondemand* embossing.
  * If you call this endpoint, the [Change card password](ref:put-v2-card-password) endpoint will no longer add the card for embossing.
  * This endpoint requires an account token - an access token encoded with a Pismo account ID. 
  * This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Card issuing - Cards",
    "version": "1.4.6",
    "description": "Card endpoints API",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing."
    },
    {
      "url": "https://gw-pci.pismolabs.io",
      "description": "Sandbox PCI API server for testing."
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Embossing",
      "description": "Card embossing endpoints"
    }
  ],
  "components": {
    "parameters": {
      "cardId": {
        "in": "path",
        "name": "cardId",
        "schema": {
          "type": "string"
        },
        "description": "Pismo card ID",
        "example": "12345",
        "required": true
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in an \"Unauthorized\" error.",
        "bearerFormat": "JWT"
      }
    },
    "responses": {
      "401Unauthorized": {
        "description": "Access token is missing or invalid"
      },
      "500InternalServer": {
        "description": "Internal server error"
      }
    }
  },
  "paths": {
    "/embossing/v1/cards/{cardId}/embossing": {
      "put": {
        "operationId": "put-cards-embossing",
        "summary": "Add card to next scheduled embossing",
        "description": "\nAdd card to next scheduled embossing. \n\nYou can use this endpoint for On Demand embossing. For more information, refer to [Embossing rules](https://developers.pismo.io/pismo-docs/docs/physical-card-embossing#embossing-rules) > On Demand embossing and [Embossing flows](https://developers.pismo.io/pismo-docs/docs/physical-card-embossing#embossing-flow).\n\n**IMPORTANT**: \n  * You should only call this endpoint **AFTER** the [Card can be added to next scheduled embossing](https://developers.pismo.io/events/docs/cards-embossing-card-ingress-1) event is received. This event is generated when a card is created and all necessary asynchronous PCI configuration is done.\n  * This endpoint does **NOT** generate an event.\n\n**Notes:**\n  * To use this endpoint, request it with a [Jira ticket](https://developers.pismo.io/pismo-docs/docs/opening-a-service-desk-ticket) with type = Settings and ask to use *ondemand* embossing.\n  * If you call this endpoint, the [Change card password](https://developers.pismo.io/pismo-docs/reference/put-v2-card-password) endpoint will no longer add the card for embossing.\n  * This endpoint requires an account token - an access token encoded with a Pismo account ID. \n  * This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.\n",
        "tags": [
          "Embossing"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/cardId"
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "description": "",
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "string",
                      "description": "Error code"
                    },
                    "message": {
                      "type": "string",
                      "description": "Error message"
                    },
                    "status": {
                      "type": "integer",
                      "description": "Error status"
                    },
                    "error": {
                      "type": "string",
                      "description": "Error"
                    }
                  }
                },
                "examples": {
                  "example-bad-request": {
                    "value": {
                      "message": "the field card_id is required",
                      "error": "bad_request",
                      "status": 400,
                      "error_code": ""
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "description": "",
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example-card-not-found": {
                    "value": {
                      "message": "card not found",
                      "error": "not_found",
                      "status": 404,
                      "error_code": ""
                    }
                  }
                }
              }
            }
          },
          "406": {
            "description": "StatusNotAcceptable",
            "content": {
              "application/json": {
                "schema": {
                  "description": "",
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example-card-not-found": {
                    "value": {
                      "message": "Card already embossed",
                      "error": "StatusNotAcceptable",
                      "status": 406,
                      "error_code": ""
                    }
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/500InternalServer"
          }
        }
      }
    }
  }
}
```