> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caret.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Note from Audio

> Create a new note from an uploaded audio file (Enterprise only)

<Note>This endpoint is available only for Enterprise plan users.</Note>

### Request Body

<ParamField body="audioUrl" type="string" required>
  The URL of the uploaded audio file (obtained from [Generate Audio Upload
  URL](/api-reference/notes/generate-upload-url))
</ParamField>

<ParamField body="title" type="string">
  Optional title for the note
</ParamField>

<ParamField body="calendarEventId" type="string">
  Optional calendar event ID to associate with the note
</ParamField>

<ParamField body="folderId" type="string">
  Optional folder ID to place the note in
</ParamField>

### Response

<ResponseField name="noteId" type="string">
  The ID of the created note
</ResponseField>

<RequestExample>
  ```bash curl theme={null}
  curl --request POST \
    --url https://api.caret.so/v1/notes/from-audio \
    --header 'Authorization: Bearer <your_api_key>' \
    --header 'Content-Type: application/json' \
    --data '{
      "audioUrl": "https://caret-cdn.s3.us-west-1.amazonaws.com/audio/temp_upload_..."
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "noteId": "mtg_987654321"
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "error": {
      "code": "forbidden",
      "message": "API key does not have the required permissions"
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "not_found",
      "message": "User not found"
    }
  }
  ```
</ResponseExample>

### Usage Flow

1. First, call [Generate Audio Upload URL](/api-reference/notes/generate-upload-url) to get a presigned URL
2. Upload your audio file to the presigned URL using a PUT request
3. Call this endpoint with the `audioUrl` returned from step 1

The note will be created with status `postprocessing` and will be processed asynchronously. Once processing is complete, the note will contain the transcript and AI-generated summary.