# Start a Smokeball connection

**GET /legal/smokeball/connect**

Returns the Smokeball authorization URL to send the user to, for the firm's Smokeball `region` (us, au or uk; us by default). The first user to connect becomes the firm's primary connection. Returns 409 when the caller already has an active Smokeball connection in this organization and 403 while the Smokeball integration is turned off. Requires a member role or above in the organization.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters
### Headers

- **organization** (string)
  id of the selected (active) organization



### Query parameters

- **region** (string)
  The firm's Smokeball region (defaults to 'us')



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



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