--- title: "Updates an integration" method: PATCH path: "/api/v2/integrations/{id}" tags: ["Integrations"] --- # Updates an integration `PATCH /api/v2/integrations/{id}` ## 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/{id}` - Auth: none declared ## Path parameters - `id` string, required ## Request body - object: Request body for creating or updating an integration. - `data` object: The JSON:API data object containing the integration resource attributes and relationships. - `attributes` object: Integration attributes. ## Response `200` Single integration - object: Single integration record in JSON:API format. - `data` object: The JSON:API data object for the returned integration resource. - `attributes` object: Integration attributes. - `account_code` AccountCode (unresolved $ref) - `account_code_mapping` AccountCodeMapping (unresolved $ref) - `bamboo_custom_field_mapping` BambooCustomFieldMapping (unresolved $ref) - `bamboo_default_subsidiary_id` BambooDefaultSubsidiaryId (unresolved $ref) - `bamboo_enable_cost_rates` BambooEnableCostRates (unresolved $ref) - `bamboo_enable_time_offs` BambooEnableTimeOffs (unresolved $ref) - `bamboo_enable_user_provisioning` BambooEnableUserProvisioning (unresolved $ref) - `bamboo_workplace_field` BambooWorkplaceField (unresolved $ref) - `bamboo_workplace_mapping` BambooWorkplaceMapping (unresolved $ref) - `calendar_write_options` CalendarWriteOptions (unresolved $ref) - `calendar_write_status` CalendarWriteStatus (unresolved $ref) - `calendars` Calendars (unresolved $ref) - `connected_at` ConnectedAt (unresolved $ref) - `customer_memo_cf_id` CustomerMemoCfId (unresolved $ref) - `deactivated_at` DeactivatedAt (unresolved $ref) - `default_item` DefaultItem (unresolved $ref) - `default_product` DefaultProduct (unresolved $ref) - `economic_export_subject` EconomicExportSubject (unresolved $ref) - `economic_product_mapping` EconomicProductMapping (unresolved $ref) - `exact_country` ExactCountry (unresolved $ref) - `exact_default_journal` ExactDefaultJournal (unresolved $ref) - `exact_default_ledger` ExactDefaultLedger (unresolved $ref) - `exact_division` ExactDivision (unresolved $ref) - `exact_division_id` string, nullable: Exact Online division ID used for the integration. - `exact_divisions` ExactDivisions (unresolved $ref) - `exact_ledger_manually` ExactLedgerManually (unresolved $ref) - `exact_ledger_mapping` ExactLedgerMapping (unresolved $ref) - `expense_account_code_mapping` ExpenseAccountCodeMapping (unresolved $ref) - `export_attachment` ExportAttachment (unresolved $ref) - `export_expense_attachment` ExportExpenseAttachment (unresolved $ref) - `export_number` ExportNumber (unresolved $ref) - `export_purchase_order_number` ExportPurchaseOrderNumber (unresolved $ref) - `folders` Folders (unresolved $ref) - `fortnox_account_mapping` FortnoxAccountMapping (unresolved $ref) - `fortnox_article_mapping` FortnoxArticleMapping (unresolved $ref) - `fortnox_default_account` FortnoxDefaultAccount (unresolved $ref) - `fortnox_default_article` FortnoxDefaultArticle (unresolved $ref) - `google_events_write_scope` GoogleEventsWriteScope (unresolved $ref) - `hubspot_default_company_id` HubspotDefaultCompanyId (unresolved $ref) - `hubspot_default_deal_owner_id` HubspotDefaultDealOwnerId (unresolved $ref) - `hubspot_default_subsidiary_id` HubspotDefaultSubsidiaryId (unresolved $ref) - `hubspot_default_template_id` HubspotDefaultTemplateId (unresolved $ref) - `hubspot_pipelines` HubspotPipelines (unresolved $ref) - `hubspot_stages_mapping` HubspotStagesMapping (unresolved $ref) - `hubspot_sync_deals` HubspotSyncDeals (unresolved $ref) - `import_attachment` ImportAttachment (unresolved $ref) - `import_number` ImportNumber (unresolved $ref) - `integration_type_id` IntegrationTypeId (unresolved $ref) - `item_mapping` ItemMapping (unresolved $ref) - `jira_organization` JiraOrganization (unresolved $ref) - `jira_project` JiraProject (unresolved $ref) - `last_synced_at` LastSyncedAt (unresolved $ref) - `name` Name (unresolved $ref) - `netsuite_customer_field_mapping` NetsuiteCustomerFieldMapping (unresolved $ref) - `netsuite_customer_form_id` NetsuiteCustomerFormId (unresolved $ref) - `netsuite_default_item` NetsuiteDefaultItem (unresolved $ref) - `netsuite_default_subsidiary_id` NetsuiteDefaultSubsidiaryId (unresolved $ref) - `netsuite_invoice_field_mapping` NetsuiteInvoiceFieldMapping (unresolved $ref) - `netsuite_invoice_form_id` NetsuiteInvoiceFormId (unresolved $ref) - `netsuite_item_mapping` NetsuiteItemMapping (unresolved $ref) - `netsuite_line_item_field_mapping` NetsuiteLineItemFieldMapping (unresolved $ref) - `netsuite_project_field_mapping` NetsuiteProjectFieldMapping (unresolved $ref) - `netsuite_project_form_id` NetsuiteProjectFormId (unresolved $ref) - `netsuite_relationship_mapping` NetsuiteRelationshipMapping (unresolved $ref) - `netsuite_sales_order_field_mapping` NetsuiteSalesOrderFieldMapping (unresolved $ref) - `netsuite_sales_order_form_id` NetsuiteSalesOrderFormId (unresolved $ref) - `options` object: Raw integration options object containing provider-specific configuration. - `payments_import` PaymentsImport (unresolved $ref) - `purchase_order_account_code_mapping` PurchaseOrderAccountCodeMapping (unresolved $ref) - `quickbooks_default_expense_account_code` QuickbooksDefaultExpenseAccountCode (unresolved $ref) - `quickbooks_default_expense_bank_account_code` QuickbooksDefaultExpenseBankAccountCode (unresolved $ref) - `quickbooks_default_expense_payment_type` QuickbooksDefaultExpensePaymentType (unresolved $ref) - `quickbooks_memo` QuickbooksMemo (unresolved $ref) - `realm_id` RealmId (unresolved $ref) - `redirect_uri` RedirectUri (unresolved $ref) - `request_token` RequestToken (unresolved $ref) - `request_uri` RequestUri (unresolved $ref) - `requested_at` RequestedAt (unresolved $ref) - `sage_business_name` SageBusinessName (unresolved $ref) - `sage_country` SageCountry (unresolved $ref) - `sage_default_ledger` SageDefaultLedger (unresolved $ref) - `sage_intacct_account_code` SageIntacctAccountCode (unresolved $ref) - `sage_intacct_account_code_mapping` SageIntacctAccountCodeMapping (unresolved $ref) - `sage_intacct_entities` SageIntacctEntities (unresolved $ref) - `sage_intacct_export_project` SageIntacctExportProject (unresolved $ref) - `sage_intacct_project_category` SageIntacctProjectCategory (unresolved $ref) - `sage_ledger_mapping` SageLedgerMapping (unresolved $ref) - `slack_options` SlackOptions (unresolved $ref) - `tax_rate_mapping` TaxRateMapping (unresolved $ref) - `twinfield_cost_center_mapping` TwinfieldCostCenterMapping (unresolved $ref) - `twinfield_default_cost_center` TwinfieldDefaultCostCenter (unresolved $ref) - `twinfield_default_ledger` TwinfieldDefaultLedger (unresolved $ref) - `twinfield_default_project` TwinfieldDefaultProject (unresolved $ref) - `twinfield_invoice_destiny` TwinfieldInvoiceDestiny (unresolved $ref) - `twinfield_ledger_mapping` TwinfieldLedgerMapping (unresolved $ref) - `twinfield_offices` TwinfieldOffices (unresolved $ref) - `twinfield_project_mapping` TwinfieldProjectMapping (unresolved $ref) - `update_invoice_sent_status` UpdateInvoiceSentStatus (unresolved $ref) - `use_companies_export` UseCompaniesExport (unresolved $ref) - `use_expense_sync` UseExpenseSync (unresolved $ref) - `use_expenses_in_xero` UseExpensesInXero (unresolved $ref) - `use_invoices_export` UseInvoicesExport (unresolved $ref) - `use_purchase_orders_export` UsePurchaseOrdersExport (unresolved $ref) - `xero_default_expense_account_code` XeroDefaultExpenseAccountCode (unresolved $ref) - `xero_default_purchase_order_account_code` XeroDefaultPurchaseOrderAccountCode (unresolved $ref) - `xero_expense_status_id` XeroExpenseStatusId (unresolved $ref) - `xero_internal_note_cf_id` XeroInternalNoteCfId (unresolved $ref) - `xero_invoice_status_id` XeroInvoiceStatusId (unresolved $ref) - `xero_organization_id` string, nullable: Xero organization ID for the connected Xero account. - `xero_organizations` XeroOrganizations (unresolved $ref) - `xero_purchase_order_status_id` XeroPurchaseOrderStatusId (unresolved $ref) - `xero_reference` XeroReference (unresolved $ref) - `all_folders` AllFolders (unresolved $ref) - `client_id` ClientId (unresolved $ref) - `netsuite_attach_timesheet` NetsuiteAttachTimesheet (unresolved $ref) - `netsuite_credit_note_form_id` NetsuiteCreditNoteFormId (unresolved $ref) - `netsuite_customer_fixed_value_mapping` NetsuiteCustomerFixedValueMapping (unresolved $ref) - `netsuite_invoice_fixed_value_mapping` NetsuiteInvoiceFixedValueMapping (unresolved $ref) - `netsuite_invoice_pdf_source` NetsuiteInvoicePdfSource (unresolved $ref) - `netsuite_line_item_fixed_value_mapping` NetsuiteLineItemFixedValueMapping (unresolved $ref) - `salesforce_default_service_type_id` SalesforceDefaultServiceTypeId (unresolved $ref) - `salesforce_default_subsidiary_id` SalesforceDefaultSubsidiaryId (unresolved $ref) - `salesforce_product_family_mapping` SalesforceProductFamilyMapping (unresolved $ref) - `salesforce_project_template_id` SalesforceProjectTemplateId (unresolved $ref) - `salesforce_stage_id` SalesforceStageId (unresolved $ref) - `salesforce_subsidiary_field` SalesforceSubsidiaryField (unresolved $ref) - `salesforce_subsidiary_mapping` SalesforceSubsidiaryMapping (unresolved $ref) - `netsuite_invoice_entity_type` NetsuiteInvoiceEntityType (unresolved $ref) - `netsuite_create_customers_on_export` NetsuiteCreateCustomersOnExport (unresolved $ref) - `netsuite_sync_customer_addresses` NetsuiteSyncCustomerAddresses (unresolved $ref) - `relationships` object: Integration relationships. - `creator` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `deal` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `organization` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `project` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `subsidiary` union: A JSON:API single relationship — links to one related resource or `null`. - SingleLinkageNullable - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID. - `id` string, required: The unique identifier of the resource. - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`). - NotIncluded: Placeholder for a relationship that was not sideloaded in this response. - `meta` object, required: Metadata indicating the sideload status of this relationship. - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant. - `included` unknown[]: Sideloaded related resources. - unknown - `meta` Meta: Pagination and response metadata returned with every collection endpoint. - `current_page` integer: The current page number in this paginated response (1-based). - `max_page_size` integer: Maximum number of records allowed per page for this endpoint. - `organization_features` object: Feature flags and capabilities enabled for the current organization, used for UI rendering. - `page_size` integer: Number of records returned per page in this response. - `settings` object: Organization or user settings relevant to this resource's display. - `total_count` integer: Total number of records matching the current query across all pages. - `total_pages` integer: Total number of pages available for the current query and page size. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `406`: Not Acceptable - `408`: Request Timeout - `415`: Unsupported Media Type - `422`: Unprocessable Content - `423`: Locked - `429`: Too Many Requests - `500`: Internal Server Error ## Changes - **2026-11-03** `7dcc2525e812`: 1 warning - added the new `datev_automatic_accounts_invalid` enum value to the `errors/items/code` response property for the response status `422` - **2026-11-02** `fa3060fd0144`: 5 warning, 9 info - added the new `bad_decimal_format` enum value to the `errors/items/code` response property for the response status `422` - added the new `non_finite_number` enum value to the `errors/items/code` response property for the response status `422` - added the new `null_bytes_in_params` enum value to the `errors/items/code` response property for the response status `422` - added the new `personio_account_mismatch` enum value to the `errors/items/code` response property for the response status `422` - …10 more - **2026-10-30** `c1d50c4b9aa6`: 3 info - added the optional property `data/attributes/netsuite_create_customers_on_export` to the response with the `200` status - added the optional property `data/attributes/netsuite_invoice_entity_type` to the response with the `200` status - added the optional property `data/attributes/netsuite_sync_customer_addresses` to the response with the `200` status - **2026-10-27** `f11a8740641a`: 1 info - endpoint added - …this revision’s changelog is incomplete [Operation history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/integrations/:id/patch.md) --- [API](https://skmtc.dev/productive/apis/api-documentation.md) - [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/productive/apis/api-documentation/revisions/e7bdfdf6cba3?raw)