POST
/
v1
/
interactions
Create an interaction
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"
  }
}

Authorizations

Authorization
string
header
required

API key for authentication

Body

application/json

Response

200
application/json

The created interaction.

The response is of type object.