Skip to main content
POST
https://integrations.projectcor.com
/
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"
}