Sets the contractor's main rate, the same way an employer's rate edit does. A main rate without a service_start_date is updated in place and keeps its id. A main rate with one belongs to a Statement of Work and is kept: seeding adds a new main rate beside it, and the list endpoint returns both while that Statement of Work is in force. This lets the rate endpoints be exercised without going through contract signature. Contractor of Record contractors, including ones not active yet, and Contractor Management Plus contractors whose contract is signed cannot be seeded, since their Statement of Work sets the rate: the endpoint returns 422.

The currency is derived from the legal entity the contractor is paid in by. A rate in a currency the contractor cannot be paid in is rejected with 422.

This endpoint is only available in Sandbox, otherwise it will respond with a 404.

Authentication

This endpoint accepts any one of the following token types:

• Company-scoped access token (OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
• Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
• Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.

{
  "amount": "103.83",
  "pay_frequency": "monthly",
  "type": "hourly"
}

{
  "data": {
    "amount": {
      "amount": "109.87",
      "currency": {
        "code": "EUR",
        "name": "Euro",
        "symbol": "€"
      }
    },
    "contract_expiration_date": null,
    "contract_start_date": "2026-01-01",
    "id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
    "pay_frequency": "monthly",
    "service_end_date": null,
    "service_start_date": "2026-01-01",
    "type": "hourly"
  }
}