---
title: "Create Callback State"
method: POST
path: "/vault/connections/{unified_api}/{service_id}/callback-state"
tags: ["Connections"]
---

# Create Callback State

`POST /vault/connections/{unified_api}/{service_id}/callback-state`

This endpoint creates a callback state that can be used to issue requests to the callback endpoint.

## Path parameters

- `service_id` string, required
- `unified_api` string, required

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required

## Request body

- CreateCallbackState
  - `redirect_uri` string — The redirect URI to be used after the connection is created.

## Response `200`

Callback state created

- CreateCallbackStateResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `data` object, required
    - `state` string — Callback state
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable
- `default` — Unexpected error

---

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