Core

Profiles

List profiles visible to the authenticated user

GET
/v1/profiles
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Response 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

POST
/v1/profiles
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

namestring
description?string
color?string

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"
  }
}
Empty
{
  "error": "Unauthorized"
}
Empty

Get a profile by id

GET
/v1/profiles/{profileId}
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Path Parameters

profileIdstring

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)

DELETE
/v1/profiles/{profileId}
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Path Parameters

profileIdstring

Response Body

application/json

application/json

application/json

curl -X DELETE "https://getlate.dev/api/v1/profiles/string"
{
  "message": "Profile deleted successfully"
}
Empty
{
  "error": "Unauthorized"
}
Empty
{
  "error": "Not found"
}

Update a profile

PUT
/v1/profiles/{profileId}
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Path Parameters

profileIdstring
name?string
description?string
color?string
isDefault?boolean

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"
}