naftiko: 1.0.0-alpha2 info: label: Unified.to API — contact description: 'Unified.to API — contact. 18 operations. Lead operation: List All Contacts. Self-contained Naftiko capability covering one Unified To business surface.' tags: - Unified To - contact created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: UNIFIED_TO_API_KEY: UNIFIED_TO_API_KEY capability: consumes: - type: http namespace: full-contact baseUri: https://api.unified.to description: Unified.to API — contact business capability. Self-contained, no shared references. resources: - name: accounting-connection_id-contact path: /accounting/{connection_id}/contact operations: - name: listaccountingcontacts method: GET description: List All Contacts outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: type in: query type: string - name: org_id in: query type: string description: The org ID to filter by (reference to AccountingOrganization) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createaccountingcontact method: POST description: Create a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: accounting-connection_id-contact-id path: /accounting/{connection_id}/contact/{id} operations: - name: removeaccountingcontact method: DELETE description: Remove a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: getaccountingcontact method: GET description: Retrieve a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: patchaccountingcontact method: PATCH description: Update a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateaccountingcontact method: PUT description: Update a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: body in: body type: object description: Request body (JSON). required: true - name: crm-connection_id-contact path: /crm/{connection_id}/contact operations: - name: listcrmcontacts method: GET description: List All Contacts outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: company_id in: query type: string description: The company ID to filter by (reference to CrmCompany) - name: deal_id in: query type: string description: The deal ID to filter by (reference to CrmDeal) - name: user_id in: query type: string description: The user/employee ID to filter by (reference to HrisEmployee) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createcrmcontact method: POST description: Create a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: crm-connection_id-contact-id path: /crm/{connection_id}/contact/{id} operations: - name: removecrmcontact method: DELETE description: Remove a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: getcrmcontact method: GET description: Retrieve a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: patchcrmcontact method: PATCH description: Update a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updatecrmcontact method: PUT description: Update a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: body in: body type: object description: Request body (JSON). required: true - name: uc-connection_id-contact path: /uc/{connection_id}/contact operations: - name: listuccontacts method: GET description: List All Contacts outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: user_id in: query type: string description: The user/employee ID to filter by (reference to HrisEmployee) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createuccontact method: POST description: Create a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: uc-connection_id-contact-id path: /uc/{connection_id}/contact/{id} operations: - name: removeuccontact method: DELETE description: Remove a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: getuccontact method: GET description: Retrieve a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: patchuccontact method: PATCH description: Update a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateuccontact method: PUT description: Update a Contact outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Contact required: true - name: body in: body type: object description: Request body (JSON). required: true authentication: type: apikey key: authorization value: '{{env.UNIFIED_TO_API_KEY}}' placement: header exposes: - type: rest namespace: full-contact-rest port: 8080 description: REST adapter for Unified.to API — contact. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/accounting/{connection-id}/contact name: accounting-connection-id-contact description: REST surface for accounting-connection_id-contact. operations: - method: GET name: listaccountingcontacts description: List All Contacts call: full-contact.listaccountingcontacts with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query type: rest.type org_id: rest.org_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createaccountingcontact description: Create a Contact call: full-contact.createaccountingcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/accounting/{connection-id}/contact/{id} name: accounting-connection-id-contact-id description: REST surface for accounting-connection_id-contact-id. operations: - method: DELETE name: removeaccountingcontact description: Remove a Contact call: full-contact.removeaccountingcontact with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getaccountingcontact description: Retrieve a Contact call: full-contact.getaccountingcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchaccountingcontact description: Update a Contact call: full-contact.patchaccountingcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateaccountingcontact description: Update a Contact call: full-contact.updateaccountingcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/crm/{connection-id}/contact name: crm-connection-id-contact description: REST surface for crm-connection_id-contact. operations: - method: GET name: listcrmcontacts description: List All Contacts call: full-contact.listcrmcontacts with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query company_id: rest.company_id deal_id: rest.deal_id user_id: rest.user_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createcrmcontact description: Create a Contact call: full-contact.createcrmcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/crm/{connection-id}/contact/{id} name: crm-connection-id-contact-id description: REST surface for crm-connection_id-contact-id. operations: - method: DELETE name: removecrmcontact description: Remove a Contact call: full-contact.removecrmcontact with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getcrmcontact description: Retrieve a Contact call: full-contact.getcrmcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchcrmcontact description: Update a Contact call: full-contact.patchcrmcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updatecrmcontact description: Update a Contact call: full-contact.updatecrmcontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/uc/{connection-id}/contact name: uc-connection-id-contact description: REST surface for uc-connection_id-contact. operations: - method: GET name: listuccontacts description: List All Contacts call: full-contact.listuccontacts with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query user_id: rest.user_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createuccontact description: Create a Contact call: full-contact.createuccontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/uc/{connection-id}/contact/{id} name: uc-connection-id-contact-id description: REST surface for uc-connection_id-contact-id. operations: - method: DELETE name: removeuccontact description: Remove a Contact call: full-contact.removeuccontact with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getuccontact description: Retrieve a Contact call: full-contact.getuccontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchuccontact description: Update a Contact call: full-contact.patchuccontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateuccontact description: Update a Contact call: full-contact.updateuccontact with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: full-contact-mcp port: 9090 transport: http description: MCP adapter for Unified.to API — contact. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-all-contacts description: List All Contacts hints: readOnly: true destructive: false idempotent: true call: full-contact.listaccountingcontacts with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query type: tools.type org_id: tools.org_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-contact description: Create a Contact hints: readOnly: false destructive: false idempotent: false call: full-contact.createaccountingcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-contact description: Remove a Contact hints: readOnly: false destructive: true idempotent: true call: full-contact.removeaccountingcontact with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-contact description: Retrieve a Contact hints: readOnly: true destructive: false idempotent: true call: full-contact.getaccountingcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-contact description: Update a Contact hints: readOnly: false destructive: false idempotent: true call: full-contact.patchaccountingcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-contact-2 description: Update a Contact hints: readOnly: false destructive: false idempotent: true call: full-contact.updateaccountingcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-contacts-2 description: List All Contacts hints: readOnly: true destructive: false idempotent: true call: full-contact.listcrmcontacts with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query company_id: tools.company_id deal_id: tools.deal_id user_id: tools.user_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-contact-2 description: Create a Contact hints: readOnly: false destructive: false idempotent: false call: full-contact.createcrmcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-contact-2 description: Remove a Contact hints: readOnly: false destructive: true idempotent: true call: full-contact.removecrmcontact with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-contact-2 description: Retrieve a Contact hints: readOnly: true destructive: false idempotent: true call: full-contact.getcrmcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-contact-3 description: Update a Contact hints: readOnly: false destructive: false idempotent: true call: full-contact.patchcrmcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-contact-4 description: Update a Contact hints: readOnly: false destructive: false idempotent: true call: full-contact.updatecrmcontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-contacts-3 description: List All Contacts hints: readOnly: true destructive: false idempotent: true call: full-contact.listuccontacts with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query user_id: tools.user_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-contact-3 description: Create a Contact hints: readOnly: false destructive: false idempotent: false call: full-contact.createuccontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-contact-3 description: Remove a Contact hints: readOnly: false destructive: true idempotent: true call: full-contact.removeuccontact with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-contact-3 description: Retrieve a Contact hints: readOnly: true destructive: false idempotent: true call: full-contact.getuccontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-contact-5 description: Update a Contact hints: readOnly: false destructive: false idempotent: true call: full-contact.patchuccontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-contact-6 description: Update a Contact hints: readOnly: false destructive: false idempotent: true call: full-contact.updateuccontact with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $.