---
title: "Share secure card details via EMAIL or RETURN methods"
method: POST
path: "/cards/{cardId}/share-secure-details"
tags: ["Share secure card details"]
---

# Share secure card details via EMAIL or RETURN methods

`POST /cards/{cardId}/share-secure-details`

This endpoint allows the user to create a link to share secure card details for a specific card

## Path parameters

- `cardId` string, required

## Request body

- CardShareSecureCardDetailsRequest — Share secure card details request
  - `shareCardDetails` CardShareDetails
    - `method` 'RETURN' | 'EMAIL' — Method to share secure card details. Can be one of RETURN or EMAIL. Will default to EMAIL if not provided.
    - `emails` string[] — Emails to share secure card details with. Optional: Required if no method provided or if method EMAIL. Must be null for method RETURN
    - `noOfLinkAccesses` integer — Number of times token/link shared will be accessible. Default of 3
    - `expiryDate` string, date — Date of expiry of the secure card details link should be default of 15 days. Must match date format of yyyy-mm-dd and be in the future.
    - `otherDetailsToShare` string[] — List of other card details to share. Will be validated against fields in card response. Default is nothing.
    - `message` string — Message to be shared with the details. Only alphanumeric characters maximum of 200 and allowed chars -/:€$£#¢%().,!@
    - `externalReference` string — External reference for the shared secure detail link

## Response `201`

Share secure card details link successfully created

## Other responses

- `400` — Invalid request
- `403` — Invalid permissions

---

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