# Create a signing

**POST /authentisign/v3/users/{userId}/signings**

Creates a new signing with one or more documents. The request is sent as `multipart/form-data`.


## Servers
- Production API gateway: https://gateway.lwolf.com (Production API gateway)
- Environment-specific host (e.g. pre-production): https://api.pre.lwolf.com (Environment-specific host (e.g. pre-production))


## Authentication methods
- Bearer auth & Subscription key


## Parameters

### Path parameters

- **userId** (string(uuid))
  Unique identifier (GUID) of the acting user. All Transact Workflow resources are scoped to a user.


### Query parameters

- **api-version** (string)
  Authentisign API version. Use `3`.


### Body: multipart/form-data (object)

- **Name** (string)
  Display name of the signing.

- **isOrdered** (boolean)
  Whether participants must sign in order.

- **ExpirationDate** (string(date-time))
  Expiration date of the signing.

- **Files** (string(binary))
  Document file(s) to include in the signing.

- **CallbackUrl** (string(uri))
  Optional callback URL invoked on signing events.

- **TransactionId** (string(uuid))
  Optional GUID of the transaction to associate the signing with.



## Responses
### 201
Signing created.

### 400
The request is malformed or contains invalid parameters.

#### Body: application/json (object)
- **error** (string)
  Error code or short error name.

- **message** (string)
  Human-readable error description.


### 401
The access token is missing, invalid, or expired.

#### Body: application/json (object)
- **error** (string)
  Error code or short error name.

- **message** (string)
  Human-readable error description.


### 403
The caller is not permitted to perform this operation.

#### Body: application/json (object)
- **error** (string)
  Error code or short error name.

- **message** (string)
  Human-readable error description.


### 404
The requested resource does not exist.

#### Body: application/json (object)
- **error** (string)
  Error code or short error name.

- **message** (string)
  Human-readable error description.



[Powered by Bump.sh](https://bump.sh)