Create a new Sub-Account (Formerly Location) based on the data provided
!
This feature is only available on Agency Pro ($497) plan.
**Version Header:** `2021-07-28`
**Operation ID:** `create-location`
**Tags:** Sub-Account (Formerly Location)
### cURL
```bash
curl -X POST 'https://rest.gohighlevel.com/v1/locations/' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Version: 2021-07-28' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'User-Agent: YourApp/1.0' \
-d '{}' # See request body schema below
```
### Python (http.client)
```python
import http.client
import json
conn = http.client.HTTPSConnection('rest.gohighlevel.com')
headers = {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Version': '2021-07-28',
'Content-Type': 'application/json',
'Accept': 'application/json',
'User-Agent': 'YourApp/1.0',
}
payload = json.dumps({})
conn.request('POST', '/v1/locations/', body=payload, headers=headers)
response = conn.getresponse()
data = json.loads(response.read().decode())
print(json.dumps(data, indent=2))
conn.close()
```
### n8n HTTP Node
```json
{
"name": "GHL - POST locations",
"type": "n8n-nodes-base.httpRequest",
"parameters": {
"method": "POST",
"url": "https://rest.gohighlevel.com/v1/locations/",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "Authorization",
"value": "Bearer YOUR_API_TOKEN"
},
{
"name": "Version",
"value": "2021-07-28"
},
{
"name": "Content-Type",
"value": "application/json"
},
{
"name": "Accept",
"value": "application/json"
},
{
"name": "User-Agent",
"value": "YourApp/1.0"
}
]
},
"sendBody": true,
"bodyParameters": {
"parameters": []
},
"options": {}
}
}
```
**To use in n8n:**
1. Add an HTTP Request node
2. Switch to JSON mode (Parameters → use RAW JSON)
3. Paste the JSON above
4. Update `YOUR_API_TOKEN` with your actual GHL API key
### Request Body Schema
- **name** (string) (required) (e.g. `Mark Shoes`): The name for the sub-account/location
- **phone** (string) (e.g. `+1410039940`): The phone number of the business for which sub-account is created with the appropriate country-code
- **companyId** (string) (required) (e.g. `UAXssdawIWAWD`): Company/Agency Id
- **address** (string) (e.g. `4th fleet street`): The address of the business for which sub-account is created
- **city** (string) (e.g. `New York`): The city where the business is located for which sub-account is created
- **state** (string) (e.g. `Illinois`): The state in which the business operates for which sub-account is created
- **country** (string) (e.g. `US`): The 2 letter country-code in which the business is present for which sub-account is created
- **postalCode** (string) (e.g. `567654`): The postal code of the business for which sub-account is created
- **website** (string) (e.g. `https://yourwebsite.com`): The website of the business for which sub-account is created
- **timezone** (string) (e.g. `US/Central`): The timezone of the business for which sub-account is created
- **prospectInfo** (string) (e.g. `{'firstName': 'John', 'lastName': 'Doe', 'email': 'john.doe@mail.com'}`)
- **settings** (string): The default settings for location
- **social** (string): The social media links for location
- **twilio** (string): The twilio credentials for location
- **mailgun** (string): The mailgun credentials for location
- **snapshotId** (string) (e.g. `XXXXXXXXXXX`): The snapshot ID to be loaded into the location.
### Response Codes
| Code | Description | Schema |
|------|-------------|--------|
| `200` | Successful response | - **id** (string) (e.g. `ve9EPM428h8vShlRW1KT`): Location Id