> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formabledocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a signing URL for a recipient signature

> Generates a signing URL for a specific recipient on a signature request. Use the `recipientSignatureId` returned when creating the signature request. The URL can be used to access the signing interface for that recipient.



## OpenAPI

````yaml /api-reference/openapi.json post /recipient-signatures/{recipientSignatureId}/url
openapi: 3.0.0
info:
  title: Formable API
  version: 1.0.0
  description: External API for redlining and e-signatures.
servers:
  - url: https://api.formabledocs.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Templates
    description: Upload documents and generate editor URLs.
  - name: Signature Requests
    description: Send documents for e-signature and retrieve signed results.
  - name: Redlining
    description: Create and manage collaborative redline negotiations.
  - name: Billing
    description: Retrieve usage information.
  - name: Health
    description: Service health checks.
paths:
  /recipient-signatures/{recipientSignatureId}/url:
    post:
      tags:
        - Signature Requests
      summary: Create a signing URL for a recipient signature
      description: >-
        Generates a signing URL for a specific recipient on a signature request.
        Use the `recipientSignatureId` returned when creating the signature
        request. The URL can be used to access the signing interface for that
        recipient.
      parameters:
        - in: path
          name: recipientSignatureId
          required: true
          schema:
            type: string
          description: The ID of the recipient signature
          example: abc123xyz
      responses:
        '200':
          description: Signing URL created successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - signingUrl
                  - expiresAt
                properties:
                  signingUrl:
                    type: string
                    format: uri
                    description: >-
                      The generated signing URL for the recipient (embed in an
                      iframe)
                    example: https://app.formabledocs.com/sign/embedded/xyz789abc
                  expiresAt:
                    type: string
                    format: date-time
                    description: >-
                      ISO 8601 timestamp when the signing URL expires (1 hour
                      from creation)
                    example: '2024-01-16T10:30:00.000Z'
        '400':
          description: Bad request - missing or invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message describing what was invalid
                    example: RecipientSignatureId is required
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          description: >-
            Forbidden - client not authorized to create a signing URL for this
            recipient signature
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message indicating authorization failure
                    example: >-
                      Client not authorized to create a signing url for this
                      recipient signature
        '404':
          description: Recipient signature not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: >-
                      Error message indicating the recipient signature was not
                      found
                    example: Recipient signature not found for id abc123xyz
        '409':
          description: Conflict - envelope has already been completed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Envelope has already been completed
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Generic error message for internal server errors
                    example: Internal server error
      security:
        - bearerAuth: []
components:
  responses:
    UnauthorizedError:
      description: Unauthorized - missing or invalid bearer token
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Auth token not valid
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````