Leads
Task & Calendar
Transactions
Communication
AI Copilot
Agents
Create a new agent
Creates a new agent under the caller’s team using the supplied profile.
Notes:
- accountInfo.phoneNumber and accountInfo.emailAddress are required.
- When phoneCode is omitted, ‘1’ (US) is used by default.
- When roleName is supplied, it is resolved to the team’s matching role; unknown names are ignored and the agent is created without a role binding.
- Long text fields (address, licenseId, position, personalWebsite, personalIntroduction, social-media item values) are silently truncated to their individual limits.
- The response envelope carries errorCode = 0 on success; non-zero values indicate validation failure or upstream error, with errorMsg describing the cause.
POST
/
v1.0
/
agent
/
profile
/
add
Create a new agent
curl --request POST \
--url https://api.lofty.com/v1.0/agent/profile/add \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"accountType": 123,
"accountInfo": {
"lastName": "Bob",
"firstName": "Bob",
"emailAddress": "aaaa@google.com",
"headUrl": "http://xxx",
"phoneNumber": "83834748",
"phoneCode": "000001",
"phoneCountry": "000001",
"tagIds": [
12345,
67890
],
"sendingEmail": "<string>",
"domain": "<string>",
"allowChangeDomain": true,
"roleName": "role of the agent",
"groupId": 123,
"roleId": 123,
"seatTypeName": "Full Time Agent"
},
"workInfo": {
"streetAddress": "123 Main St",
"city": "New York",
"country": "US",
"state": "NY",
"zipcode": "10001",
"licenseId": "xxx",
"companyName": "xxx",
"companyAddress": "xxx",
"position": "xxx",
"personalWebsite": "xxx",
"personalAttachments": [
{
"fileName": "<string>",
"size": 123,
"queryLink": "<string>",
"contentType": "<string>"
}
],
"personalDisclaimers": [
{
"fileName": "<string>",
"size": 123,
"queryLink": "<string>",
"contentType": "<string>"
}
],
"personalIntroduction": "xxx"
},
"socialMedias": {
"items": [
{
"type": "<string>",
"name": "<string>",
"value": "<string>"
}
]
},
"personalPhotos": {
"urls": [
"<string>"
]
},
"hasBackOffice": true,
"agentPid": "<string>",
"fullSync": true,
"shouldSync": true,
"checkRosterNum": true
}
'{
"data": 100234,
"errorCode": 0,
"errorMsg": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://developer.lofty.com/llms.txt
Use this file to discover all available pages before exploring further.
Body
application/json
Agent profile payload.
The account type of the agent
Account Base Info of agent, like name , email or phone and something else
Show child attributes
Show child attributes
Work Info of agent, include company info etc..
Show child attributes
Show child attributes
Social media of agent, include company info
Show child attributes
Show child attributes
Personal photos of agent
Show child attributes
Show child attributes
Response
Envelope with the new agent's user ID, or a non-zero errorCode on failure.
Response for POST /v1.0/agent/profile/add. Envelope that carries the new agent's user ID and an error code when creation fails.
⌘I
Create a new agent
curl --request POST \
--url https://api.lofty.com/v1.0/agent/profile/add \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"accountType": 123,
"accountInfo": {
"lastName": "Bob",
"firstName": "Bob",
"emailAddress": "aaaa@google.com",
"headUrl": "http://xxx",
"phoneNumber": "83834748",
"phoneCode": "000001",
"phoneCountry": "000001",
"tagIds": [
12345,
67890
],
"sendingEmail": "<string>",
"domain": "<string>",
"allowChangeDomain": true,
"roleName": "role of the agent",
"groupId": 123,
"roleId": 123,
"seatTypeName": "Full Time Agent"
},
"workInfo": {
"streetAddress": "123 Main St",
"city": "New York",
"country": "US",
"state": "NY",
"zipcode": "10001",
"licenseId": "xxx",
"companyName": "xxx",
"companyAddress": "xxx",
"position": "xxx",
"personalWebsite": "xxx",
"personalAttachments": [
{
"fileName": "<string>",
"size": 123,
"queryLink": "<string>",
"contentType": "<string>"
}
],
"personalDisclaimers": [
{
"fileName": "<string>",
"size": 123,
"queryLink": "<string>",
"contentType": "<string>"
}
],
"personalIntroduction": "xxx"
},
"socialMedias": {
"items": [
{
"type": "<string>",
"name": "<string>",
"value": "<string>"
}
]
},
"personalPhotos": {
"urls": [
"<string>"
]
},
"hasBackOffice": true,
"agentPid": "<string>",
"fullSync": true,
"shouldSync": true,
"checkRosterNum": true
}
'{
"data": 100234,
"errorCode": 0,
"errorMsg": "<string>"
}