---
updatedAt: 2025-06-09T22:08:13.000Z
agentTools:
  projectIndex: https://streak.readme.io/llms.txt
---

# Create a new meeting

This call lets you create a new [meeting](reference#meeting-notes) associated with a particular [box](reference#get-a-box).

> 🚧 Content Type and Auth
>
> Make sure to include `-H "Content-Type: application/x-www-form-urlencoded"` and your authorization in any request you make on your own.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "streak-v2-url-encoded",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.streak.com/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/boxes/{key}/meetings": {
      "post": {
        "summary": "Create a new meeting",
        "description": "This call lets you create a new [meeting](reference#meeting-notes) associated with a particular [box](reference#get-a-box).",
        "operationId": "create-a-new-meeting",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "description": "The key of the box you want the meeting created in.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "meetingType",
                  "startTimestamp"
                ],
                "properties": {
                  "meetingType": {
                    "type": "string",
                    "description": "The type of meeting you're creating:`MEETING_NOTES` or`CALL_LOG`",
                    "default": "MEETING_NOTES"
                  },
                  "startTimestamp": {
                    "type": "string",
                    "description": "The date and time the meeting was created in milliseconds since server start.",
                    "default": "1369697984568",
                    "format": "date-time"
                  },
                  "duration": {
                    "type": "integer",
                    "description": "The duration of the meeting in milliseconds.",
                    "default": 1800000,
                    "format": "int32"
                  },
                  "notes": {
                    "type": "string",
                    "description": "The **unicode** content of the meeting note or call log."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"boxKey\": \"agxzfm1ha\",\n  \"pipelineKey\": \"Wxmb29nYWV\",\n  \"orgKey\": \"agxzfm1ha\",\n  \"creatorKey\": \"agxzfm1ha\",\n  \"creationDate\": 1543268186504,\n  \"key\": \"agxzfm1haWxmb29\",\n  \"meetingType\": \"CALL_LOG\",\n  \"startTimestamp\": 1543268158247,\n  \"duration\": 480000,\n  \"notes\": \"Moving forward with the Journey Into Night narrative. Adding real stakes to the park might be the wrong move, but it sounds like the investors might be on board. Behavior seems to think that there will be no way to measure effectiveness of the work because the results will be too obvious. Look into expanding parks?\",\n  \"lastSavedTimestamp\": 1543270412555\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "boxKey": {
                      "type": "string",
                      "example": "agxzfm1ha"
                    },
                    "pipelineKey": {
                      "type": "string",
                      "example": "Wxmb29nYWV"
                    },
                    "orgKey": {
                      "type": "string",
                      "example": "agxzfm1ha"
                    },
                    "creatorKey": {
                      "type": "string",
                      "example": "agxzfm1ha"
                    },
                    "creationDate": {
                      "type": "integer",
                      "example": 1543268186504,
                      "default": 0
                    },
                    "key": {
                      "type": "string",
                      "example": "agxzfm1haWxmb29"
                    },
                    "meetingType": {
                      "type": "string",
                      "example": "CALL_LOG"
                    },
                    "startTimestamp": {
                      "type": "integer",
                      "example": 1543268158247,
                      "default": 0
                    },
                    "duration": {
                      "type": "integer",
                      "example": 480000,
                      "default": 0
                    },
                    "notes": {
                      "type": "string",
                      "example": "Moving forward with the Journey Into Night narrative. Adding real stakes to the park might be the wrong move, but it sounds like the investors might be on board. Behavior seems to think that there will be no way to measure effectiveness of the work because the results will be too obvious. Look into expanding parks?"
                    },
                    "lastSavedTimestamp": {
                      "type": "integer",
                      "example": 1543270412555,
                      "default": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```