Skip to main content
POST
/
v2
/
integrations
/
users
curl --location 'https://integrations.projectcor.com/v2/integrations/users' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "id": "OKTA-USER-12345",
  "email": "john.doe@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1 555-0100",
  "position": "Senior Developer",
  "department": "Engineering",
  "role_id": 4,
  "daily_hours": 8,
  "user_position_id": "external-user-position-1",
  "seniority_id": "external_seniority_id_10"
}'

{
  "id": 8546,
  "email": "john.doe@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1 555-0100",
  "role_id": 4,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}
Creates a new user in your COR instance through the integrations service. The user is mapped to an external ID from your identity provider or HR system.

​
Request Body Requirements

​
metadata
object
required
​
id
string
required
External user ID from your source system (e.g., Okta user ID, SAP employee ID)
​
email
string
required
User’s email address
​
first_name
string
required
User’s first name
​
last_name
string
required
User’s last name
​
phone
string
Phone number
​
position
string
Job position/title
​
department
string
Department name
​
role_id
number
COR role ID: 1 (C-Level), 2 (Director), 3 (Project Manager), 4 (Collaborator), 5 (Freelancer), 6 (Client)
​
daily_hours
number
Daily working hours capacity (default: 8)
​
user_position_id
string
External position ID. The position must have been previously created through the integrations API. Assigns the user to this position.
​
seniority_id
string
External seniority ID. The seniority must have been previously created through the integrations API. Assigns this seniority level to the user.

​
Known Errors

  • ValidationError — Missing required fields
  • DuplicateEmailError — A user with this email already exists
  • DuplicateExternalIdError — A user with this external ID already exists for this source
  • InvalidRoleError — The role_id is not a valid COR role
curl --location 'https://integrations.projectcor.com/v2/integrations/users' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "id": "OKTA-USER-12345",
  "email": "john.doe@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1 555-0100",
  "position": "Senior Developer",
  "department": "Engineering",
  "role_id": 4,
  "daily_hours": 8,
  "user_position_id": "external-user-position-1",
  "seniority_id": "external_seniority_id_10"
}'

{
  "id": 8546,
  "email": "john.doe@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1 555-0100",
  "role_id": 4,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}