curl --request POST \
--url https://api.folk.app/v1/interactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"entity": {
"id": "per_55175e81-9a52-4ac3-930e-82792c23499b"
},
"dateTime": "2025-07-17T09:00:00.000Z",
"title": "Coffee with John Doe",
"content": "Had a coffee with John Doe\nDiscussed the new project.",
"type": "☕️"
}'
{
"data": {
"id": "lit_b049db09-c03d-4f32-96d6-d314760add5d",
"title": "Coffee with John Doe",
"content": "Had a coffee with John Doe\nDiscussed the new project.",
"entity": {
"id": "per_55175e81-9a52-4ac3-930e-82792c23499b",
"entityType": "person",
"fullName": "John Doe"
},
"dateTime": "2025-07-17T09:00:00.000Z",
"type": "coffee"
}
}
Creates a new interaction with a person or a company.
curl --request POST \
--url https://api.folk.app/v1/interactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"entity": {
"id": "per_55175e81-9a52-4ac3-930e-82792c23499b"
},
"dateTime": "2025-07-17T09:00:00.000Z",
"title": "Coffee with John Doe",
"content": "Had a coffee with John Doe\nDiscussed the new project.",
"type": "☕️"
}'
{
"data": {
"id": "lit_b049db09-c03d-4f32-96d6-d314760add5d",
"title": "Coffee with John Doe",
"content": "Had a coffee with John Doe\nDiscussed the new project.",
"entity": {
"id": "per_55175e81-9a52-4ac3-930e-82792c23499b",
"entityType": "person",
"fullName": "John Doe"
},
"dateTime": "2025-07-17T09:00:00.000Z",
"type": "coffee"
}
}
API key for authentication
The created interaction.
The response is of type object
.