---
title: "Create a new data request token for form authentication"
method: POST
path: "/data_requests/{data_request_id}/tokens"
tags: ["Data Requests"]
---

# Create a new data request token for form authentication

`POST /data_requests/{data_request_id}/tokens`

Creates an authentication token for accessing a data request form. Tokens can be created
for API access (1 hour expiration) or email links (30 day expiration). Returns a token
and a pre-authenticated URL for the data request form.

See also:
- [Embedded Data Requests Guide](https://docspring.com/docs/guides/embedded-forms/embedded-data-requests/)

## Path parameters

- `data_request_id` string, required

## Query parameters

- `type` 'api' | 'email'

## Response `201`

token created

- object
  - `status` 'success' | 'error', required
  - `token` SubmissionDataRequestToken, required
    - `id` string, nullable, required
    - `secret` string, required
    - `expires_at` string, nullable, required
    - `data_request_url` string, nullable, required
  - `errors` string[]

## Other responses

- `401` — authentication failed
- `422` — invalid request

---

[API](https://skmtc.dev/docspring/apis/docspring-api.md) · [All operations](https://skmtc.dev/docspring/apis/docspring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docspring/docspring-api/revisions/5726657b9432/schema)