Create User

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"
}'

import requests

url = "https://integrations.projectcor.com/v2/integrations/users"

payload = {
    "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"
}

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch(
  'https://integrations.projectcor.com/v2/integrations/users',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      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
    })
  }
);

const data = await response.json();
console.log(data);

{
  "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"
}

{
  "error": "DuplicateEmailError",
  "message": "A user with email 'john.doe@company.com' already exists",
  "code": "ZC002"
}

POST

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"
}'

import requests

url = "https://integrations.projectcor.com/v2/integrations/users"

payload = {
    "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"
}

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch(
  'https://integrations.projectcor.com/v2/integrations/users',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      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
    })
  }
);

const data = await response.json();
console.log(data);

{
  "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"
}

{
  "error": "DuplicateEmailError",
  "message": "A user with email 'john.doe@company.com' already exists",
  "code": "ZC002"
}

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

object

required

Show properties

string

required

Integration source identifier. Must be one of: JIRA, SALESFORCE, ADVERTMIND, QUICKBOOKS, ZAPIER, OKTA, MICROSOFT_DYNAMICS, GITHUB, MICROSOFT_TEAMS, VBS, SAP, GLOBANT

string

required

External user ID from your source system (e.g., Okta user ID, SAP employee ID)

string

required

User’s email address

string

required

User’s first name

string

required

User’s last name

string

Phone number

string

Job position/title

string

Department name

number

COR role ID: 1 (C-Level), 2 (Director), 3 (Project Manager), 4 (Collaborator), 5 (Freelancer), 6 (Client)

number

Daily working hours capacity (default: 8)

string

External position ID. The position must have been previously created through the integrations API. Assigns the user to this position.

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"
}'

import requests

url = "https://integrations.projectcor.com/v2/integrations/users"

payload = {
    "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"
}

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch(
  'https://integrations.projectcor.com/v2/integrations/users',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      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
    })
  }
);

const data = await response.json();
console.log(data);

{
  "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"
}

{
  "error": "DuplicateEmailError",
  "message": "A user with email 'john.doe@company.com' already exists",
  "code": "ZC002"
}

⌘I

Introduction

Brands

Clients

Contracts

Currency Exchanges

Products

Positions

Position Categories

Seniority

Projects

Teams

Users

User Leaves

Working Time

Workspaces

Request Body Requirements

Known Errors

​Request Body Requirements

​Known Errors

Request Body Requirements

Known Errors