---
title: "Create a meeting for a specific contact"
description: "POST /contacts/{contact_id}/meetings — Logs a meeting against this contact. place is free-form text (max 100 characters); meeting_time records when it happened."
canonical_url: https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-meetings/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-meetings/
---

`POST /contacts/{contact_id}/meetings`

Logs a meeting against this contact. place is free-form text (max 100 characters); meeting_time records when it happened.

Resource: [Contacts](https://developer.onepagecrm.com/api/reference/contacts/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X POST "https://app.onepagecrm.com/api/v3/contacts/{contact_id}/meetings" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_time_int": 1525273653,
    "place": "Meeting room 1",
    "text": "Mary is interested in coming into the office on Tuesday.",
    "user_ids_to_notify": [
      "5aba31e99007ba0f570c12f7"
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `contact_id` | string | Contact ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `meeting_time_int` | integer (unix-timestamp) |  | Time the meeting occurred in UNIX Epoch time (defaults to current time, if left blank) |
| `place` | string |  | The place in which the meeting take place |
| `text` | string |  | Extra details related to the meeting (supports `[b]bold[/b]` and `[i]italic[/i]` formatting) |
| `user_ids_to_notify` | array<string (bson-id)> |  | A list of user IDs to notify |

## Responses

### 201

Created

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "meeting": {
      "id": "5afc1b69d556730b580596cb",
      "contact_id": "5ae06ef9d55673108fe8877f",
      "text": "Mary is interested in coming into the office on Tuesday.",
      "meeting_time_int": 1525273653,
      "place": "Meeting room 1",
      "author": "Jane D.",
      "attachments": [
        {
          "id": "5afc1ea9d556730b780096db",
          "filename": "mario.jpg",
          "custom_filename": "another_mario.jpg",
          "pinned": true,
          "pinned_at": "2022-01-24T10:42:39Z",
          "size": 3841,
          "storage_provider": "amazon",
          "url": "https://{foo.bar}/mario.jpg",
          "url_expires_at": "2018-05-16T13:06:53Z",
          "thumbnail": {
            "url": "https://{foo.bar}/mario-thumbnail.jpg"
          }
        }
      ],
      "created_at": "2018-05-16T11:52:09Z",
      "modified_at": "2018-05-16T11:52:09Z",
      "index": 1
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)