---
title: "Create a new consent"
method: POST
path: "/connectivity/v2/consents"
tags: ["Connectivity v2.Consent", "BETA"]
---

# Create a new consent

`POST /connectivity/v2/consents`

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateConsentRequest — Provide the consent parameters.
  - `financialService` Connectivity20v2FinancialService, required — unresolved $ref
  - `financialServiceParameters` Connectivity20v2FinancialServiceParameters, required — unresolved $ref
  - `providerId` string, required — The provider (financial institution) name that the consent is connected to.
  - `userId` string, required — The user unique id that the consent is connected to.

## Response `201`

Consent successfully created.

- CreateConsentResponse
  - `consent` Connectivity20v2Consent — unresolved $ref

## Other responses

- `400` — Invalid input.
- `401` — Unauthorized request.
- `403` — Permission denied.
- `409` — Request retried while the original request is still being processed.
- `422` — Attempt to reuse an idempotency key with a different request payload.
- `500` — Internal server error.

---

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