openapi: 3.1.0 info: title: Act! Web API — SyncData version: v1 description: Act! Web API is a JSON-based REST API for the Act! CRM database, exposing contacts, companies, groups, opportunities, activities, notes, history and custom entities. Reads support OData query options ($filter, $orderby, $top, $skip, $select, $expand) and requests may be batched via POST /api/$batch. Authentication is a JWT bearer token obtained from GET /authorize using HTTP Basic credentials plus an Act-Database-Name header. contact: name: Act! Developers url: https://www.act.com/developer/ termsOfService: https://www.act.com/legal/terms-of-service/ servers: - url: https://apimta.act.com/act.web.api description: Act! Premium Cloud API — US region (host and basePath as published in the provider Swagger document). - url: https://{server}/{customer}-api/act.web.api description: Act! Premium Cloud tenant endpoint, per the Act! Web API home page. variables: server: default: apimta.act.com customer: default: customer - url: https://{server}/act.web.api description: Self-hosted Act! Premium for Web / Act! Premium Windows IIS deployment. variables: server: default: localhost tags: - name: SyncData security: - bearerAuth: [] actDatabaseName: [] paths: /api/sync-data/search-contacts-by-business-email: post: tags: - SyncData summary: Get contacts identifiers by business emails. operationId: SyncData_PostSearchContactsByBusinessEmail_094FD90D requestBody: required: true content: application/json: schema: type: array items: type: string application/xml: schema: type: array items: type: string text/xml: schema: type: array items: type: string application/x-www-form-urlencoded: schema: type: array items: type: string description: Array of business emails. responses: '200': description: OK indicates that the request succeeded and that the requested information is in the response. content: application/json: schema: type: object additionalProperties: type: string application/xml: schema: type: object additionalProperties: type: string text/xml: schema: type: object additionalProperties: type: string '400': description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code. '401': description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication. '500': description: Unexpected error. /api/sync-data/search-synced-external-ids: post: tags: - SyncData summary: Find existed identifiers. operationId: SyncData_PostSearchSyncedExternalId_8F2C702D requestBody: required: true content: application/json: schema: type: array items: type: string application/xml: schema: type: array items: type: string text/xml: schema: type: array items: type: string application/x-www-form-urlencoded: schema: type: array items: type: string description: Array of external ids. responses: '200': description: OK indicates that the request succeeded and that the requested information is in the response. content: application/json: schema: type: array items: type: string application/xml: schema: type: array items: type: string text/xml: schema: type: array items: type: string '400': description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code. '401': description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication. '500': description: Unexpected error. /api/sync-data/search-synced-calendar-uids: post: tags: - SyncData summary: Find existed calendar identifiers with related external ids. operationId: SyncData_PostSearchSyncedCalendarUids_AC7119F4 requestBody: required: true content: application/json: schema: type: array items: type: string application/xml: schema: type: array items: type: string text/xml: schema: type: array items: type: string application/x-www-form-urlencoded: schema: type: array items: type: string description: Array of calendar uids. responses: '200': description: OK indicates that the request succeeded and that the requested information is in the response. content: application/json: schema: type: array items: $ref: '#/components/schemas/act.web.api.models.SyncData.ActivitySyncInfo' application/xml: schema: type: array items: $ref: '#/components/schemas/act.web.api.models.SyncData.ActivitySyncInfo' text/xml: schema: type: array items: $ref: '#/components/schemas/act.web.api.models.SyncData.ActivitySyncInfo' '400': description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code. '401': description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication. '500': description: Unexpected error. /api/email-integration-cache-refresh: post: tags: - SyncData summary: Refresh email integration cache for current user operationId: SyncData_PostRefreshEmailIntegarionCache_480299E9 responses: '204': description: Created indicates that the request resulted in a new resource created for non-authenticated user before the response was sent. content: application/json: schema: $ref: '#/components/schemas/System.Void' application/xml: schema: $ref: '#/components/schemas/System.Void' text/xml: schema: $ref: '#/components/schemas/System.Void' '400': description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code. '401': description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication. '500': description: Unexpected error. components: securitySchemes: basicAuth: type: http scheme: basic description: HTTP Basic credentials (Act! user name and password, RFC 7617) presented to GET /authorize together with the Act-Database-Name header to mint a JWT bearer token. bearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'JWT bearer token returned by GET /authorize (RFC 6750). Sent as Authorization: Bearer on every API request.' actDatabaseName: type: apiKey in: header name: Act-Database-Name description: Name of the Act! database the request is scoped to. schemas: System.Void: type: object properties: {} act.web.api.models.SyncData.ActivitySyncInfo: description: Activty sync info type: object properties: activityId: description: Activity identifier. type: string externalId: description: External id type: string calendarUid: description: Calendar Uid type: string