---
title: "Create Profile Note"
method: POST
path: "/api/v2/core/profile-notes"
tags: ["Profile Note"]
---

# Create Profile Note

`POST /api/v2/core/profile-notes`

Create a profile note for a candidate. profileId is required. noteType must be one of note, email, other, title_note — email is intended for internal integrations or callers from allowed domains only, as email notes appear in sourcing analytics and recruiter dashboards. positionId is optional.

## Query parameters

- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Request body

- NoteCreateRequestSchema
  - `profileId` string, required — Profile id of candidate
  - `positionId` string, nullable — Position id associated with the note
  - `noteType` 'note' | 'email' | 'other', nullable — Note type of candidate. Valid values: note, email, other. Note: email is intended for internal integrations or callers from allowed domains only — email notes appear in sourcing analytics and recruiter dashboards.
  - `note` string, nullable — Note of candidate

## Response `200`

OK

- Note
  - `creatorEmail` string, nullable — creator email of candidate
  - `id` string, nullable — Note id of candidate
  - `noteType` string, nullable — Note type of candidate
  - `note` string, nullable — Note of candidate
  - `profileId` string, nullable — Profile id of candidate
  - `positionId` string, nullable — Position id associated with the note
  - `createdTime` integer, nullable — created time of candidate in datetime format

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)