Profiles
Create and manage profiles to organize connected social media accounts with the Late API
List profiles visible to the authenticated user
Returns profiles within the user's plan limit. Profiles are sorted by creation date (oldest first).
Use includeOverLimit=true to include profiles that exceed the plan limit (for management/deletion purposes).
API key authentication - use your Late API key as a Bearer token
In: header
Query Parameters
When true, includes profiles that exceed the user's plan limit.
Over-limit profiles will have isOverLimit: true in the response.
Useful for managing/deleting profiles after a plan downgrade.
falseResponse Body
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/profiles"{
"profiles": [
{
"_id": "64f0...",
"name": "Personal Brand",
"color": "#ffeda0",
"isDefault": true
}
]
}{
"error": "Unauthorized"
}Create a new profile
API key authentication - use your Late API key as a Bearer token
In: header
Response Body
application/json
application/json
curl -X POST "https://getlate.dev/api/v1/profiles" \ -H "Content-Type: application/json" \ -d '{ "name": "Marketing Team", "description": "Profile for marketing campaigns", "color": "#4CAF50" }'{
"message": "Profile created successfully",
"profile": {
"_id": "64f0a1b2c3d4e5f6a7b8c9d0",
"userId": "6507a1b2c3d4e5f6a7b8c9d0",
"name": "Marketing Team",
"description": "Profile for marketing campaigns",
"color": "#4CAF50",
"isDefault": false,
"createdAt": "2024-11-01T10:00:00Z"
}
}{
"error": "Unauthorized"
}Get a profile by id
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://getlate.dev/api/v1/profiles/string"{
"profile": {
"_id": "64f0a1b2c3d4e5f6a7b8c9d0",
"userId": "6507a1b2c3d4e5f6a7b8c9d0",
"name": "Marketing Team",
"description": "Profile for marketing campaigns",
"color": "#4CAF50",
"isDefault": false,
"createdAt": "2024-11-01T10:00:00Z"
}
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Delete a profile (must have no connected accounts)
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X DELETE "https://getlate.dev/api/v1/profiles/string"{
"message": "Profile deleted successfully"
}{
"error": "Unauthorized"
}{
"error": "Not found"
}Update a profile
API key authentication - use your Late API key as a Bearer token
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X PUT "https://getlate.dev/api/v1/profiles/string" \ -H "Content-Type: application/json" \ -d '{ "name": "Marketing Team (Updated)", "color": "#2196F3", "isDefault": true }'{
"message": "Profile updated successfully",
"profile": {
"_id": "64f0a1b2c3d4e5f6a7b8c9d0",
"userId": "6507a1b2c3d4e5f6a7b8c9d0",
"name": "Marketing Team (Updated)",
"description": "Profile for marketing campaigns",
"color": "#2196F3",
"isDefault": true,
"createdAt": "2024-11-01T10:00:00Z"
}
}{
"error": "Unauthorized"
}{
"error": "Not found"
}