---
title: "Create card relationships"
method: POST
path: "/flex_credentials/v1/vfc/relationship/cards/{cardId}"
tags: ["Relationships"]
---

# Create card relationships

`POST /flex_credentials/v1/vfc/relationship/cards/{cardId}`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/flex_credentials/v1/vfc/relationship/cards/{cardId}`
- Auth: none declared. Required headers: `access_token`

Create relationships between primary and secondary cards.

## Path parameters

- `cardId` string, required

## Headers

- `access_token` string, required

## Request body

- RelationshipCardRequest
  - `cards` object[], required
    - `cardID` integer, required: ID of card to create relationship for
    - `roleType` 'SECONDARY_DEBIT' | 'SECONDARY_CREDIT' | 'SECONDARY_LOC' | 'SECONDARY_INSTALLMENT' | 'SECONDARY_PREPAID', required: Card role type: * `SECONDARY_DEBIT`—Debit card * `SECONDARY_CREDIT`—Credit card * `SECONDARY_LOC`—Secondary/fallback funding source * `SECONDARY_INSTALLMENT`—Installment plan * `SECONDARY_PREPAID`—Prepaid card
    - `isFallback` boolean, required: Is this the fallback card? Only one card can be a fallback card.

## Response `201`

Success

- RelationshipResponse
  - `cardID` integer, required: Primary card ID
  - `cards` object[], required
    - `cardID` integer, required: Secondary card ID
    - `roleType` 'SECONDARY_DEBIT' | 'SECONDARY_CREDIT' | 'SECONDARY_LOC' | 'SECONDARY_INSTALLMENT' | 'SECONDARY_PREPAID', required: Card role type: * `SECONDARY_DEBIT`—Debit card * `SECONDARY_CREDIT`—Credit card * `SECONDARY_LOC`—Secondary/fallback funding source * `SECONDARY_INSTALLMENT`—Installment plan * `SECONDARY_PREPAID`—Prepaid card
    - `isFallback` boolean, required: Is this the fallback card? Only one card can be a fallback card.

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)