Profiles

A profile in Luella captures the context of your business, offering, and outreach to make sure any messages Luella sends are aligned with your actual sales narrative and target segment. These are used to contextualize campaign messaging, dynamically populate personalization fields, and ensure consistent outreach themes.

The profile model

The profile model captures relevant information about your intended outreach target, your offer, and any segmentation strategy you want to apply to prospecting.

Properties

Name
profileId
Type
string
Description
Unique identifier for the profile.
Name
workspaceId
Type
string
Description
Unique identifier for the workspace that the profile belongs to.
Name
profileName
Type
string
Description
Optional name for identifying the profile in your Luella dashboard.
Name
profileTargetType
Type
string
Description
Describes whether the outreach is cold, warm, upsell, etc.
Name
profileTargetICPs
Type
string[]
Description
Ideal customer profile titles this profile is targeting.
Name
profileTargetIndustries
Type
string[]
Description
Industries or verticals that this profile is focused on.
Name
profileTargetSize
Type
string
Description
Company size or segmentation tier for this profile.
Name
profileTargetOfferDescription
Type
string
Description
A short description of your offer as it will be presented in outreach.

POST/profiles/ListProfiles

List all profiles

This endpoint allows you to retrieve a paginated list of all profiles created under a workspace. Profiles help tailor messaging based on ICP, industry, size, and offer positioning.

Required attributes

Name
userId
Type
string
Description
Unique identifier for the user making the request.
Name
workspaceId
Type
string
Description
Unique identifier for the workspace the profiles belong to.

Optional attributes

Name
nextToken
Type
string
Description
Token used for pagination through the result set.
Name
maxItems
Type
integer
Description
Limits the number of profiles returned.

Request

POST

/profiles/ListProfiles

{
  "userId": "user_123",
  "workspaceId": "workspace_456",
  "maxItems": 10
}

Response

{
  "profiles": [
    {
      "profileId": "profile_001",
      "profileName": "B2B SaaS Mid-Market",
      "profileTargetType": "Cold Outbound",
      "createdAt": "2024-11-10T15:12:00.000Z"
    }
  ],
  "nextToken": null
}

POST/profiles/CreateProfile

Create a new profile

This endpoint allows you to create a new profile that defines targeting and offer information for outreach personalization.

Required attributes

Name
userId
Type
string
Description
User making the request.
Name
workspaceId
Type
string
Description
Workspace where this profile is to be created.

Optional attributes

Name
profileName
Type
string
Description
Name of the profile.
Name
profileTargetType
Type
string
Description
Nature of outreach (cold, upsell, etc).
Name
profileTargetICPs
Type
string[]
Description
Roles/titles targeted.
Name
profileTargetIndustries
Type
string[]
Description
Industries this profile targets.
Name
profileTargetSize
Type
string
Description
Company size.
Name
profileTargetOfferDescription
Type
string
Description
Offer or value prop used for personalization.

Request

POST

/profiles/CreateProfile

{
  "userId": "user_123",
  "workspaceId": "workspace_456",
  "profileName": "Mid-Market SaaS",
  "profileTargetType": "Cold Outbound",
  "profileTargetICPs": ["Sales Managers"],
  "profileTargetIndustries": ["SaaS", "E-commerce"],
  "profileTargetSize": "51-200",
  "profileTargetOfferDescription": "Automated outreach tools"
}

Response

{
  "workspaceId": "workspace_456",
  "profileId": "profile_001"
}

POST/profiles/GetProfile

Get a profile

Retrieve detailed information about a specific profile using its unique profile ID.

Required attributes

Name
userId
Type
string
Description
The user making the request.
Name
workspaceId
Type
string
Description
The workspace containing the profile.
Name
profileId
Type
string
Description
The profile you want to retrieve.

Request

POST

/profiles/GetProfile

{
  "userId": "user_123",
  "workspaceId": "workspace_456",
  "profileId": "profile_001"
}

Response

{
  "profileId": "profile_001",
  "profileName": "Mid-Market SaaS",
  "profileTargetType": "Cold Outbound",
  "profileTargetICPs": ["Sales Managers"],
  "profileTargetIndustries": ["SaaS", "E-commerce"],
  "profileTargetSize": "51-200",
  "profileTargetOfferDescription": "Automated outreach tools"
}

POST/profiles/UpdateProfile

Update a profile

Update an existing profile with new target or offer data.

Required attributes

Name
userId
Type
string
Description
The user making the request.
Name
workspaceId
Type
string
Description
The workspace where the profile exists.
Name
profileId
Type
string
Description
The profile to update.

Optional attributes

Name
profileName
Type
string
Description
Updated name.
Name
profileTargetType
Type
string
Description
Updated outreach type.
Name
profileTargetICPs
Type
string[]
Description
Updated ICPs.
Name
profileTargetIndustries
Type
string[]
Description
Updated industries.
Name
profileTargetSize
Type
string
Description
Updated company size.
Name
profileTargetOfferDescription
Type
string
Description
Updated offer description.

Request

POST

/profiles/UpdateProfile

{
  "userId": "user_123",
  "workspaceId": "workspace_456",
  "profileId": "profile_001",
  "profileName": "Updated Name",
  "profileTargetType": "Cold Outbound",
  "profileTargetICPs": ["Marketing Managers"],
  "profileTargetIndustries": ["Tech"],
  "profileTargetSize": "11-50",
  "profileTargetOfferDescription": "Targeted email solutions"
}

Response

{
  "workspaceId": "workspace_456",
  "profileId": "profile_001"
}

POST/profiles/DeleteProfile

Delete a profile

Delete a profile from your workspace using the profile ID.

Required attributes

Name
userId
Type
string
Description
The user making the request.
Name
workspaceId
Type
string
Description
Workspace that owns the profile.
Name
profileId
Type
string
Description
Unique identifier for the profile being deleted.

Request

POST

/profiles/DeleteProfile

{
  "userId": "user_123",
  "workspaceId": "workspace_456",
  "profileId": "profile_001"
}

Response

{}