Personnel

Generate outreach messages

Start asynchronous AI outreach generation for one or more personnel records, with optional event context.

Use this endpoint after personnel selection when the integration needs personalized email or LinkedIn copy. Submit up to 2,000 personnel IDs, choose email, linkedin_message, or both, and optionally provide event_id, LinkedIn variants (inmail, connection_note, connected_message), and an outreach purpose. The operation does not deduct credits.

Each personnel item can succeed or fail independently and may create background work. Store returned task identifiers and retrieve the latest generated content with the outreach detail endpoint. Generating content does not send or contact the person.

POST

external

personnel

generate-outreach-message

Generate outreach messages

curl --request POST \
  --url https://platform.lensmor.com/external/personnel/generate-outreach-message \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "personnel_ids": [
    "789"
  ],
  "event_id": "501",
  "channels": [
    "email",
    "linkedin_message"
  ],
  "linkedin_message_types": [
    "inmail",
    "connection_note"
  ],
  "outreach_purpose": "Book a product demo"
}
'

import requests

url = "https://platform.lensmor.com/external/personnel/generate-outreach-message"

payload = {
    "personnel_ids": ["789"],
    "event_id": "501",
    "channels": ["email", "linkedin_message"],
    "linkedin_message_types": ["inmail", "connection_note"],
    "outreach_purpose": "Book a product demo"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    personnel_ids: ['789'],
    event_id: '501',
    channels: ['email', 'linkedin_message'],
    linkedin_message_types: ['inmail', 'connection_note'],
    outreach_purpose: 'Book a product demo'
  })
};

fetch('https://platform.lensmor.com/external/personnel/generate-outreach-message', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.lensmor.com/external/personnel/generate-outreach-message",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'personnel_ids' => [
        '789'
    ],
    'event_id' => '501',
    'channels' => [
        'email',
        'linkedin_message'
    ],
    'linkedin_message_types' => [
        'inmail',
        'connection_note'
    ],
    'outreach_purpose' => 'Book a product demo'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.lensmor.com/external/personnel/generate-outreach-message"

	payload := strings.NewReader("{\n  \"personnel_ids\": [\n    \"789\"\n  ],\n  \"event_id\": \"501\",\n  \"channels\": [\n    \"email\",\n    \"linkedin_message\"\n  ],\n  \"linkedin_message_types\": [\n    \"inmail\",\n    \"connection_note\"\n  ],\n  \"outreach_purpose\": \"Book a product demo\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://platform.lensmor.com/external/personnel/generate-outreach-message")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"personnel_ids\": [\n    \"789\"\n  ],\n  \"event_id\": \"501\",\n  \"channels\": [\n    \"email\",\n    \"linkedin_message\"\n  ],\n  \"linkedin_message_types\": [\n    \"inmail\",\n    \"connection_note\"\n  ],\n  \"outreach_purpose\": \"Book a product demo\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://platform.lensmor.com/external/personnel/generate-outreach-message")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"personnel_ids\": [\n    \"789\"\n  ],\n  \"event_id\": \"501\",\n  \"channels\": [\n    \"email\",\n    \"linkedin_message\"\n  ],\n  \"linkedin_message_types\": [\n    \"inmail\",\n    \"connection_note\"\n  ],\n  \"outreach_purpose\": \"Book a product demo\"\n}"

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "personnel_id": "789",
      "success": true,
      "taskId": null,
      "error": null
    }
  ],
  "taskCenterId": "321"
}

{
  "code": 400,
  "message": "Invalid request",
  "errorKey": "INVALID_REQUEST",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 401,
  "message": "Invalid API key",
  "errorKey": "INVALID_API_KEY",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 409,
  "message": "Request conflicts with the current resource state",
  "errorKey": "STATE_CONFLICT",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 422,
  "message": "Selected leads limit exceeded: requested 2001, limit 2000",
  "errorKey": "LEAD_SELECTION_LIMIT_EXCEEDED",
  "details": {
    "requestedCount": 2001,
    "limit": 2000,
    "selectionMode": "selected"
  },
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 429,
  "message": "Rate limit exceeded",
  "errorKey": "RATE_LIMIT_EXCEEDED",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

Authorizations

Authorization

string

header

required

Send the full Business API key from Settings -> API Keys, for example Authorization: Bearer sk_your_api_key.

Headers

x-call-source

enum<string>

Identify the caller as api or agent for usage attribution. Defaults to api when omitted.

Available options:

api,

agent

Body

application/json

Batch AI outreach generation request for selected channels and personnel.

personnel_ids

string[]

required

Lensmor personnel identifiers selected for this batch operation. The runtime accepts an empty array, but useful generation requires at least one identifier.

Maximum array length: 2000

Example:

["789"]

channels

enum<string>[]

required

Output channels to generate: email, linkedin_message, or both. The runtime accepts an empty array, but an empty array creates no useful output.

Available options:

email,

linkedin_message

Example:

["email", "linkedin_message"]

event_id

string

Optional internal Lensmor event row identifier from the event response id field. This endpoint currently converts the value directly to BigInt; unlike most event-scoped routes, it does not resolve public eventId. Omit it to skip membership validation and event context.

Pattern: ^[0-9]+$

Example:

"501"

linkedin_message_types

enum<string>[]

LinkedIn variants to generate: inmail, connection_note, and/or connected_message.

Available options:

inmail,

connection_note,

connected_message

Example:

["inmail", "connection_note"]

outreach_purpose

string

Optional offer, call-to-action, or purpose context used to personalize the drafts.

Example:

"Invite the contact to a product demo"

Response

Outreach message generation accepted

Item-level outreach generation submissions and optional batch task identity.

items

object[]

required

Records returned on the current page or in the current batch.

Show child attributes

taskCenterId

string | null

Numeric TaskCenter identifier returned when at least one outreach generation task was created.

Pattern: ^[0-9]+$

Example:

"321"

Generate outreach messages

curl --request POST \
  --url https://platform.lensmor.com/external/personnel/generate-outreach-message \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "personnel_ids": [
    "789"
  ],
  "event_id": "501",
  "channels": [
    "email",
    "linkedin_message"
  ],
  "linkedin_message_types": [
    "inmail",
    "connection_note"
  ],
  "outreach_purpose": "Book a product demo"
}
'

import requests

url = "https://platform.lensmor.com/external/personnel/generate-outreach-message"

payload = {
    "personnel_ids": ["789"],
    "event_id": "501",
    "channels": ["email", "linkedin_message"],
    "linkedin_message_types": ["inmail", "connection_note"],
    "outreach_purpose": "Book a product demo"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    personnel_ids: ['789'],
    event_id: '501',
    channels: ['email', 'linkedin_message'],
    linkedin_message_types: ['inmail', 'connection_note'],
    outreach_purpose: 'Book a product demo'
  })
};

fetch('https://platform.lensmor.com/external/personnel/generate-outreach-message', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.lensmor.com/external/personnel/generate-outreach-message",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'personnel_ids' => [
        '789'
    ],
    'event_id' => '501',
    'channels' => [
        'email',
        'linkedin_message'
    ],
    'linkedin_message_types' => [
        'inmail',
        'connection_note'
    ],
    'outreach_purpose' => 'Book a product demo'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.lensmor.com/external/personnel/generate-outreach-message"

	payload := strings.NewReader("{\n  \"personnel_ids\": [\n    \"789\"\n  ],\n  \"event_id\": \"501\",\n  \"channels\": [\n    \"email\",\n    \"linkedin_message\"\n  ],\n  \"linkedin_message_types\": [\n    \"inmail\",\n    \"connection_note\"\n  ],\n  \"outreach_purpose\": \"Book a product demo\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://platform.lensmor.com/external/personnel/generate-outreach-message")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"personnel_ids\": [\n    \"789\"\n  ],\n  \"event_id\": \"501\",\n  \"channels\": [\n    \"email\",\n    \"linkedin_message\"\n  ],\n  \"linkedin_message_types\": [\n    \"inmail\",\n    \"connection_note\"\n  ],\n  \"outreach_purpose\": \"Book a product demo\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://platform.lensmor.com/external/personnel/generate-outreach-message")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"personnel_ids\": [\n    \"789\"\n  ],\n  \"event_id\": \"501\",\n  \"channels\": [\n    \"email\",\n    \"linkedin_message\"\n  ],\n  \"linkedin_message_types\": [\n    \"inmail\",\n    \"connection_note\"\n  ],\n  \"outreach_purpose\": \"Book a product demo\"\n}"

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "personnel_id": "789",
      "success": true,
      "taskId": null,
      "error": null
    }
  ],
  "taskCenterId": "321"
}

{
  "code": 400,
  "message": "Invalid request",
  "errorKey": "INVALID_REQUEST",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 401,
  "message": "Invalid API key",
  "errorKey": "INVALID_API_KEY",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 409,
  "message": "Request conflicts with the current resource state",
  "errorKey": "STATE_CONFLICT",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 422,
  "message": "Selected leads limit exceeded: requested 2001, limit 2000",
  "errorKey": "LEAD_SELECTION_LIMIT_EXCEEDED",
  "details": {
    "requestedCount": 2001,
    "limit": 2000,
    "selectionMode": "selected"
  },
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

{
  "code": 429,
  "message": "Rate limit exceeded",
  "errorKey": "RATE_LIMIT_EXCEEDED",
  "traceId": "2be6d7f4-3b2d-4d11-8e2d-7a2e4c3e9a10"
}

Credits

Actions

Events

Exhibitors

Personnel

Contacts

Profile Matching

Generate outreach messages

Authorizations

Headers

Body

Response