PRproductive
Integrations

Create an integration

Changed on

Create a new integration.

post/api/v2/integrations

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/integrations
  • Auth
    none declared

Request body

Example request

{
  "data": {
    "type": "integrations",
    "attributes": {
      "name": "Xero Accounting",
      "integration_type_id": 2
    },
    "relationships": {
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "2"
        }
      }
    }
  }
}

Response

Single integration

Example response

{
  "data": {
    "id": "11",
    "type": "integrations",
    "attributes": {
      "name": "Xero Accounting",
      "integration_type_id": 2,
      "connected_at": "2026-01-15T10:00:00.000+00:00",
      "deactivated_at": null,
      "account_code": "200",
      "export_number": true,
      "payments_import": true,
      "last_synced_at": "2026-03-15T08:00:00.000+00:00",
      "options": {}
    },
    "relationships": {
      "subsidiary": {
        "data": {
          "type": "subsidiaries",
          "id": "2"
        }
      },
      "creator": {
        "data": {
          "type": "people",
          "id": "12"
        }
      }
    }
  },
  "included": []
}

Changes

  • 7dcc2525e812Revision changes
    • warning

      added the new datev_automatic_accounts_invalid enum value to the // response property for the response status

  • fa3060fd0144Revision changes
    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response status

    • warning

      added the new personio_account_mismatch enum value to the // response property for the response status

    • warning

      added the new personio_time_off_types_unavailable enum value to the // response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status