# Add signing participants (batch)

**POST /authentisign/v3/api/v3/users/{userId}/participants/batch**

Adds multiple participants to a signing in a single request. The `type` field on each participant controls their role (e.g. signer vs. carbon-copy recipient).


## 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.



### Body: application/json (array[object])

- **signingId** (string(uuid))
  GUID of the signing the participant is added to.

- **firstName** (string)
  Participant first name.

- **middleName** (string)
  Participant middle name.

- **lastName** (string)
  Participant last name.

- **email** (string(email))
  Participant email address.

- **type** (integer)
  Participant role code. Observed values: `1` and `0` — these appear to distinguish signer from carbon-copy recipient roles. **TODO: confirm the code-to-role mapping and document all values.**

- **staticSignatureEnabled** (boolean)
  Whether static (typed) signatures are allowed.

- **scriptedSignatureEnabled** (boolean)
  Whether scripted (drawn) signatures are allowed.

- **imageSignatureEnabled** (boolean)
  Whether image signatures are allowed.



## Responses
### 201
Participants added.

### 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)