POST
/
api
/
v1
/
contacts
Create Partner Contact
curl --request POST \
  --url https://app.journeybee.io/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "position": "<string>",
  "phone_number": "<string>",
  "partnership_id": 123,
  "tags": [
    {}
  ]
}'
{
  "id": 123,
  "uuid": "<string>"
}

​
Authentication

curl -X POST "https://app.journeybee.io/api/v1/contacts" \
  -H "Authorization: Bearer your-api-key-uuid" \
  -H "Content-Type: application/json" \
  -d '{"email": "contact@partner.com", "first_name": "Jane", "last_name": "Doe", "partnership_id": 456}'

​
Request Body Schema

​
email
string
required
Contact email address
​
first_name
string
Contact first name
​
last_name
string
Contact last name
​
position
string
Job title or position
​
phone_number
string
Contact phone number
​
partnership_id
number
required
Associated partnership ID
​
tags
array
Array of tag IDs to assign

​
Response Schema

​
id
number
The created contact ID
​
uuid
string
The created contact UUID

​
Notes

  • Requires API key with write_access permission
  • Contact must be associated with an existing partnership
  • Helps maintain relationship management with partner companies