Skip to main content
POST
/
v2
/
integrations
/
projects
curl --location 'https://integrations.projectcor.com/v2/integrations/projects' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "id": "SF-OPP-12345",
  "name": "Website Redesign Project",
  "client_id": "SF-ACC-67890",
  "brief": "Complete website overhaul including new branding",
  "start": "2025-01-15",
  "end": "2025-03-31",
  "pm_id": "SF-USER-111",
  "estimated_time": 200,
  "billable": true,
  "status": "active",
  "estimated": 15000,
  "contract_id": "SF-CONTRACT-001",
  "work_order": "WO-2025-001"
}'

{
  "id": 155693,
  "name": "Website Redesign Project",
  "client_id": 25855,
  "brief": "Complete website overhaul including new branding",
  "start": "2025-01-15 00:00:00",
  "end": "2025-03-31 00:00:00",
  "pm_id": 8546,
  "estimated_time": 200,
  "billable": true,
  "status": "active",
  "estimated": 15000,
  "contract_id": 4521,
  "work_order": "WO-2025-001",
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}
Creates a new project in your COR instance through the integrations service. The project is mapped to an external ID from your source system (Salesforce, Jira, etc.) for bidirectional synchronization.

​
Request Body Requirements

All requests require the metadata.source field to identify the integration source.
​
metadata
object
required
​
id
string
required
External project ID from your source system. This ID will be used to reference the project in future update/delete operations.
​
name
string
required
Project name
​
client_id
string
External client ID. The client must have been previously created through the integrations API.
​
brief
string
Project description or brief
​
start
string
Project start date in YYYY-MM-DD format
​
end
string
Project end date in YYYY-MM-DD format
​
pm_id
string
External project manager user ID
​
brand_id
string
External brand ID
​
product_id
string
External product ID
​
estimated_time
number
Estimated hours for the project
​
billable
boolean
Whether the project is billable
​
status
string
Project status
​
currency_id
string
External currency ID
​
evaluation_date
string
Project evaluation date in YYYY-MM-DD format
​
estimated
number
Estimated monetary value for the project
​
fee_id
string
External fee ID
​
contract_id
string
External contract ID. The contract must have been previously created through the integrations API.
​
deliverables
string
Project deliverables description
​
work_order
string
Work order number or code
​
income_type
string
Income type for the project. Possible values: fee, one_time, hourly_rate, contract
​
archived
boolean
default:"false"
Whether the project is archived

​
Known Errors

  • ValidationError — Missing required fields (metadata.source, id, or name)
  • ClientNotFoundError — The specified client_id does not exist in the integration mappings
  • DuplicateExternalIdError — A project with this external ID already exists for this source
  • InvalidSourceError — The metadata.source value is not a valid integration source
curl --location 'https://integrations.projectcor.com/v2/integrations/projects' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "SALESFORCE"
  },
  "id": "SF-OPP-12345",
  "name": "Website Redesign Project",
  "client_id": "SF-ACC-67890",
  "brief": "Complete website overhaul including new branding",
  "start": "2025-01-15",
  "end": "2025-03-31",
  "pm_id": "SF-USER-111",
  "estimated_time": 200,
  "billable": true,
  "status": "active",
  "estimated": 15000,
  "contract_id": "SF-CONTRACT-001",
  "work_order": "WO-2025-001"
}'

{
  "id": 155693,
  "name": "Website Redesign Project",
  "client_id": 25855,
  "brief": "Complete website overhaul including new branding",
  "start": "2025-01-15 00:00:00",
  "end": "2025-03-31 00:00:00",
  "pm_id": 8546,
  "estimated_time": 200,
  "billable": true,
  "status": "active",
  "estimated": 15000,
  "contract_id": 4521,
  "work_order": "WO-2025-001",
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-10T14:30:00Z"
}