Skip to main content
POST
/
v1
/
inbound
/
notes
Create Note
curl --request POST \
  --url https://enrich.octolane.com/v1/inbound/notes \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "note": {
    "title": "<string>",
    "content": "<string>"
  },
  "account_domains": [
    "<string>"
  ],
  "contact_emails": [
    "<string>"
  ]
}
'
{
  "success": true,
  "data": {
    "note_id": "<string>",
    "title": "<string>",
    "content": "<string>"
  },
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.octolane.com/llms.txt

Use this file to discover all available pages before exploring further.

Attach notes to accounts and contacts. Use this to store context from conversations, meeting notes, lead source details, or any other info you want linked to a record.

Request

X-API-Key
string
required
Your Octolane API key.
Content-Type
string
required
Must be application/json.

Body parameters

note
object
required
The note content.
account_domains
string[]
Array of company domains to attach the note to (e.g., ["acme.com"]).
contact_emails
string[]
Array of contact emails to attach the note to (e.g., ["john@acme.com"]).
Include at least one of account_domains or contact_emails so the note is attached to a record. You can include both to link the note to both the company and the person.

Example request

curl -X POST "https://enrich.octolane.com/v1/inbound/notes" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "note": {
      "title": "Instantly Lead - First Contact",
      "content": "Reached out via cold email. Replied interested in demo."
    },
    "account_domains": ["acme.com"],
    "contact_emails": ["john@acme.com"]
  }'

Response

success
boolean
Whether the request succeeded.
data
object
message
string
Human-readable status message.
200
{
  "success": true,
  "data": {
    "note_id": "bb0e8400-e29b-41d4-a716-446655440000",
    "title": "Instantly Lead - First Contact",
    "content": "Reached out via cold email. Replied interested in demo."
  },
  "message": "Note created successfully"
}

Common use cases

Storing outbound context. When a lead from Instantly or Apollo replies, push the conversation context into Octolane as a note so your agents have full history. Meeting notes via API. After a call, push a summary note attached to the contact and account. Lead source tagging. Use the note title or content to tag where a lead came from (e.g., “Source: Instantly Cold Campaign Q1”).