---
title: "Create a Recipient URL for a Signer"
method: POST
path: "/workflows/{id}/signatures/recipient-urls"
tags: ["Workflows"]
---

# Create a Recipient URL for a Signer

`POST /workflows/{id}/signatures/recipient-urls`

## Request

- Base URL: `https://ironcladapp.com/public/api/v1`
- URL: `https://ironcladapp.com/public/api/v1/workflows/{id}/signatures/recipient-urls`
- Auth: API key in header `Authorization` and OAuth 2
  - Authorization code: `https://ironcladapp.com/oauth/authorize`
  - Client credentials
  - Token URL: `https://ironcladapp.com/oauth/token` scopes: `public.workflows.createSignatureRecipientUrls`

Create a recipient URL for a signer or viewer to access the signature request.

This functionality is exclusive to Ironclad Signature. See [this help center article](https://support.ironcladapp.com/hc/en-us/articles/12276957992983-Manage-Signatures-During-the-Sign-Step#copysignerlink) for more information.

**OAuth Scope required:** `public.workflows.createSignatureRecipientUrls`

## Path parameters

- `id` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body

- union
  - object
    - `type` 'signer', required: The type of recipient.
    - `roleName` string, required: The role name of the signer. A full list of role names can be located using the [List All Workflow Signers](https://developer.ironcladapp.com/reference/list-all-workflow-signers) endpoint.
  - object
    - `type` 'viewer', required: The type of recipient.
    - `email` string, required: The email address of the CC recipient.

## Response `201`

201

- object
  - `url` string, required: The URL for the recipient to access the signature request.

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404 not found
- `422`: 422
- `429`: 429

## Changes

- **2026-11-03** `435da5a4396e`: 1 info
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/changes/workflows/:id/signatures/recipient-urls/post.md)

---

[API](https://skmtc.dev/ironcladapp/apis/ironclad-public-api.md) - [All operations](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/revisions/435da5a4396e?raw)