> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# SuperOffice CRM connector

- Connector: `appmixer.superoffice`
- Version: 1.2.0
- Components: 39 (6 triggers, 33 actions)

SuperOffice CRM is a customer relationship management system for sales, marketing and service teams. Manage companies, persons, sales, projects and follow-ups, and react to new records.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0>
- Documentation: <https://docs.appmixer.com/connector-configuration/superoffice>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/superoffice>
- Download package: <https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/download>

## Authentication

**Type:** OAuth 2

**Scopes:**

- `openid`

## Triggers (6)

- [New Company](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.NewCompany.md) (`appmixer.superoffice.core.NewCompany`): Triggers when a new company is created. Checks SuperOffice for new companies every minute; it does not need the webhook licence.
- [New Follow-up](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.NewFollowUp.md) (`appmixer.superoffice.core.NewFollowUp`): Triggers when a new follow-up is created. Checks SuperOffice for new follow-ups every minute; it does not need the webhook licence.
- [New Person](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.NewPerson.md) (`appmixer.superoffice.core.NewPerson`): Triggers when a new person is created. Checks SuperOffice for new persons every minute; it does not need the webhook licence.
- [New Sale](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.NewSale.md) (`appmixer.superoffice.core.NewSale`): Triggers when a new sale is created. Checks SuperOffice for new sales every minute; it does not need the webhook licence.
- [New Project](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.NewProject.md) (`appmixer.superoffice.core.NewProject`): Triggers when a new project is created. Checks SuperOffice for new projects every minute; it does not need the webhook licence.
- [Record Updated](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.RecordUpdated.md) (`appmixer.superoffice.core.RecordUpdated`): Triggers when a company, person, sale, project, follow-up or ticket is updated, optionally only when a field has a value or changes to it (for example a ticket closed, a milestone reached or a follow-up completed). Checks SuperOffice every minute; it does not need the webhook licence.

## Actions (33)

- [Create Company](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateCompany.md) (`appmixer.superoffice.core.CreateCompany`): Create a company (a contact in SuperOffice). The company starts from the defaults SuperOffice sets for new companies.
- [Create Follow-up](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateFollowUp.md) (`appmixer.superoffice.core.CreateFollowUp`): Create a follow-up (an appointment, task or call) in the diary or task list.
- [Create Note](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateNote.md) (`appmixer.superoffice.core.CreateNote`): Add a note to the history of a company, person, ticket, project or sale, for example survey feedback. SuperOffice has no separate note entity: the note is a completed task.
- [Create Person](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreatePerson.md) (`appmixer.superoffice.core.CreatePerson`): Create a person (a contact person) in a company.
- [Create Project](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateProject.md) (`appmixer.superoffice.core.CreateProject`): Create a project.
- [Delete Company](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.DeleteCompany.md) (`appmixer.superoffice.core.DeleteCompany`): Delete a company. This cannot be undone.
- [Delete Follow-up](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.DeleteFollowUp.md) (`appmixer.superoffice.core.DeleteFollowUp`): Delete a follow-up. This cannot be undone.
- [Create Task](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateTask.md) (`appmixer.superoffice.core.CreateTask`): Create a follow-up task with a due date, assigned to a user and linked to a company, person, ticket, project or sale.
- [Delete Person](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.DeletePerson.md) (`appmixer.superoffice.core.DeletePerson`): Delete a person. This cannot be undone.
- [Delete Project](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.DeleteProject.md) (`appmixer.superoffice.core.DeleteProject`): Delete a project. This cannot be undone.
- [Delete Sale](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.DeleteSale.md) (`appmixer.superoffice.core.DeleteSale`): Delete a sale. This cannot be undone.
- [Find Companies](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.FindCompanies.md) (`appmixer.superoffice.core.FindCompanies`): Find companies, newest first. Returns at most 500 companies.
- [Find Follow-ups](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.FindFollowUps.md) (`appmixer.superoffice.core.FindFollowUps`): Find follow-ups, newest first. Returns at most 500 follow-ups.
- [Find Persons](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.FindPersons.md) (`appmixer.superoffice.core.FindPersons`): Find persons, newest first. Returns at most 500 persons.
- [Create Sale](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.CreateSale.md) (`appmixer.superoffice.core.CreateSale`): Create a sale (an opportunity) for a company.
- [Find Projects](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.FindProjects.md) (`appmixer.superoffice.core.FindProjects`): Find projects, newest first. Returns at most 500 projects.
- [Find Records](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.FindRecords.md) (`appmixer.superoffice.core.FindRecords`): Find companies, persons, sales, projects, follow-ups or tickets, newest first, each read in full with its owner and custom fields. Returns at most 100 records.
- [Find Sales](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.FindSales.md) (`appmixer.superoffice.core.FindSales`): Find sales, newest first. Returns at most 500 sales.
- [Get Company](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetCompany.md) (`appmixer.superoffice.core.GetCompany`): Get a company by its ID.
- [Get Follow-up](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetFollowUp.md) (`appmixer.superoffice.core.GetFollowUp`): Get a follow-up by its ID.
- [Get Person](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetPerson.md) (`appmixer.superoffice.core.GetPerson`): Get a person by its ID.
- [Get Current User](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetCurrentUser.md) (`appmixer.superoffice.core.GetCurrentUser`): Get the SuperOffice user the account is connected as, and the tenant.
- [Get Project](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetProject.md) (`appmixer.superoffice.core.GetProject`): Get a project by its ID.
- [Get Record](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetRecord.md) (`appmixer.superoffice.core.GetRecord`): Get a company, person, sale, project, follow-up or ticket by its ID, with its owner and custom fields (user-defined and extra fields).
- [Get Sale](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.GetSale.md) (`appmixer.superoffice.core.GetSale`): Get a sale by its ID.
- [List List Items](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.ListListItems.md) (`appmixer.superoffice.core.ListListItems`): List the items of a SuperOffice list, such as categories, businesses, countries, sale types or follow-up tasks. Deleted items and headings are left out.
- [Make API Call](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.MakeApiCall.md) (`appmixer.superoffice.core.MakeApiCall`): Perform an arbitrary authorized call to the SuperOffice WebAPI of your tenant. Provide a path relative to the tenant API (or a full URL on it), method, headers, query parameters and body. The Authorization header is added automatically.
- [Update Company](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.UpdateCompany.md) (`appmixer.superoffice.core.UpdateCompany`): Update a company. Only the fields you fill in are changed.
- [Update Follow-up](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.UpdateFollowUp.md) (`appmixer.superoffice.core.UpdateFollowUp`): Update a follow-up. Only the fields you fill in are changed.
- [Update Person](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.UpdatePerson.md) (`appmixer.superoffice.core.UpdatePerson`): Update a person. Only the fields you fill in are changed.
- [Update Project](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.UpdateProject.md) (`appmixer.superoffice.core.UpdateProject`): Update a project. Only the fields you fill in are changed.
- [Update Record](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.UpdateRecord.md) (`appmixer.superoffice.core.UpdateRecord`): Update a company, person, sale, project, follow-up or ticket. The fields, custom fields included, are loaded for the chosen object; empty fields keep their stored values.
- [Update Sale](https://connectors.appmixer.com/connector/appmixer.superoffice/1.2.0/component/appmixer.superoffice.core.UpdateSale.md) (`appmixer.superoffice.core.UpdateSale`): Update a sale. Only the fields you fill in are changed.

## Changelog

### 1.2.0

- Time Zone: an optional setting on every component that reads or writes a date-time, with a dropdown of time zones. It overrides the time zone the connector detects for the SuperOffice tenant (and the service config key timeZone), for tenants outside Europe or whenever the detected zone is not the one the tenant works in.

### 1.1.1

- Ticket statuses in Update Record and Record Updated are the statuses of the tenant (Open, Closed, ...): the dropdown offered other IDs, so picking Closed did not close the ticket, and in Update Record it did not load at all.
- Find Records filters by owner in the query, so it also finds matches older than the newest 100 records.
- An unassigned ticket has no owner name and a record that was never updated has no updated date, instead of placeholder values.
- Date-times are exact whatever the time zone of the SuperOffice tenant or of the server: the components return UTC (ending with Z), and a date-time they are given is stored as the local time of the tenant, which is what SuperOffice shows. Before, a time sent in UTC appeared shifted by the tenant's UTC offset. The time zone is read from SuperOffice; the service config key timeZone (an IANA name such as Europe/Oslo) overrides it.

### 1.1.0

- Generic record components for any object, tickets included: Get Record, Find Records, Update Record (standard and custom fields loaded for the chosen object), Record Updated trigger (polling, optional field or status condition), Create Task (assignee, link to a ticket or company) and Create Note.
- Tickets (requests), owners and custom fields (user-defined and extra fields) on the generic records.
- Private lookups for objects, fields, status values and users.

### 1.0.0

- Initial release: companies, persons, sales, projects and follow-ups (create, get, update, delete, find), list items, current user, New Company, New Person, New Sale, New Project and New Follow-up polling triggers, and Make API Call. OAuth 2.0 through SuperID for SuperOffice CRM Online.
