Contractors
Projects

Create a company project

Changed on

Creates a new contractor project for your company.

Authentication

This endpoint requires the following token type:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage projects (projects)-Manage projects (project:write)
post/v1/projects

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/projects
  • Auth: OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/company.manage, project:write, projects, all:write)

Request body

codestring required

Code/identifier of the project. Must be unique within the company.

descriptionstring nullable

Description of the project.

end_datestring date nullable

Date when the project ends.

namestring required

Name of the project.

start_datestring date nullable

Date when the project starts.

Example request

{
  "code": "WEB-001",
  "description": "Redesign the company website",
  "name": "Website redesign",
  "start_date": "2026-01-01"
}

Response

Created

Example response

{
  "data": {
    "project": {
      "budget": {
        "amount": 250000,
        "currency": "USD"
      },
      "code": "WEB-001",
      "description": "Redesign the company website",
      "end_date": null,
      "id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
      "lead_ids": [
        "663e0b79-c893-45ff-a1b2-f6dcabc098b5"
      ],
      "name": "Website redesign",
      "start_date": "2026-01-01",
      "status": "active",
      "team_member_ids": [
        "663e0b79-c893-45ff-a1b2-f6dcabc098b5"
      ]
    }
  }
}

Changes

  • 1692cde18808Revision changes
    • info

      the security scope projects was added to the endpoint's security scheme OAuth2AuthorizationCode

    • info

      the security scope time_and_attendance was removed from the endpoint's security scheme OAuth2AuthorizationCode

  • a7aa0c0e220bRevision changes
    • info

      endpoint added