Update User

curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "position": "Lead Developer",
  "role_id": 3,
  "daily_hours": 8,
  "user_position_id": "external-user-position-2",
  "seniority_id": "external_seniority_id_20",
  "salary": 5000,
  "salary_from": "03-2025"
}'

import requests

url = "https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345"

payload = {
    "metadata": {
        "source": "OKTA"
    },
    "position": "Lead Developer",
    "role_id": 3,
    "daily_hours": 8,
    "user_position_id": "external-user-position-2",
    "seniority_id": "external_seniority_id_20",
    "salary": 5000,
    "salary_from": "03-2025"
}

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

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

const response = await fetch(
  'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      metadata: {
        source: 'OKTA'
      },
      position: 'Lead Developer',
      role_id: 3,
      daily_hours: 8,
      salary: 5000,
      salary_from: '03-2025'
    })
  }
);

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": 3,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}

{
  "status": "ERROR",
  "code": "ZC001",
  "message": "Entity is not associated"
}

{
  "error": "UserNotFoundError",
  "message": "User with external ID 'OKTA-USER-12345' not found for source OKTA",
  "code": "ZC004"
}

PUT

integrations

users

{id}

curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "position": "Lead Developer",
  "role_id": 3,
  "daily_hours": 8,
  "user_position_id": "external-user-position-2",
  "seniority_id": "external_seniority_id_20",
  "salary": 5000,
  "salary_from": "03-2025"
}'

import requests

url = "https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345"

payload = {
    "metadata": {
        "source": "OKTA"
    },
    "position": "Lead Developer",
    "role_id": 3,
    "daily_hours": 8,
    "user_position_id": "external-user-position-2",
    "seniority_id": "external_seniority_id_20",
    "salary": 5000,
    "salary_from": "03-2025"
}

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

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

const response = await fetch(
  'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      metadata: {
        source: 'OKTA'
      },
      position: 'Lead Developer',
      role_id: 3,
      daily_hours: 8,
      salary: 5000,
      salary_from: '03-2025'
    })
  }
);

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": 3,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}

{
  "status": "ERROR",
  "code": "ZC001",
  "message": "Entity is not associated"
}

{
  "error": "UserNotFoundError",
  "message": "User with external ID 'OKTA-USER-12345' not found for source OKTA",
  "code": "ZC004"
}

Updates an existing user in your COR instance using their external ID. Only provided fields will be updated.

Path Parameters

string

required

External user ID that was used when creating the user

Request Body Requirements

object

required

Show properties

string

required

Integration source identifier. Must match the source used when creating the user.

string

Updated first name

string

Updated last name

string

Updated phone number

string

Updated job position

string

Updated department

number

Updated COR role ID

number

Updated daily hours capacity

string

External position ID. The position must have been previously created through the integrations API. Updates the user’s position assignment.

string

External seniority ID. The seniority must have been previously created through the integrations API. Updates the user’s seniority level.

number

Monthly salary amount.

string

Month from which the salary becomes effective. Must use MM-YYYY format. Defaults to the current month if salary is provided.

Known Errors

ZC001 — Entity is not associated (user with the specified external ID not found)
UserNotFoundError — No user found with the specified external ID for this source
ValidationError — Missing required metadata.source field
InvalidRoleError — The role_id is not a valid COR role
ValidationError — The salary_from field must use MM-YYYY format

curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "position": "Lead Developer",
  "role_id": 3,
  "daily_hours": 8,
  "user_position_id": "external-user-position-2",
  "seniority_id": "external_seniority_id_20",
  "salary": 5000,
  "salary_from": "03-2025"
}'

import requests

url = "https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345"

payload = {
    "metadata": {
        "source": "OKTA"
    },
    "position": "Lead Developer",
    "role_id": 3,
    "daily_hours": 8,
    "user_position_id": "external-user-position-2",
    "seniority_id": "external_seniority_id_20",
    "salary": 5000,
    "salary_from": "03-2025"
}

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

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

const response = await fetch(
  'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      metadata: {
        source: 'OKTA'
      },
      position: 'Lead Developer',
      role_id: 3,
      daily_hours: 8,
      salary: 5000,
      salary_from: '03-2025'
    })
  }
);

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": 3,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}

{
  "status": "ERROR",
  "code": "ZC001",
  "message": "Entity is not associated"
}

{
  "error": "UserNotFoundError",
  "message": "User with external ID 'OKTA-USER-12345' not found for source OKTA",
  "code": "ZC004"
}

⌘I

Introduction

Brands

Clients

Contracts

Currency Exchanges

Products

Positions

Position Categories

Seniority

Projects

Teams

Users

User Leaves

Working Time

Workspaces

Path Parameters

Request Body Requirements

Known Errors

​Path Parameters

​Request Body Requirements

​Known Errors

Path Parameters

Request Body Requirements

Known Errors