---
title: Integration setup
summary: Connect Superwise to another system, choose which events pass between them, and check the log to see what was sent.
menu: Company settings > Integration Setup
route: /integrationclients
who: People who have the View Integrations permission. Adding a client or an event needs Add. Changing needs Edit and deleting needs Delete.
---

An integration connects Superwise to another system, for example an accounting tool, so that the two share records without typing them twice. The other system is called an integration client. An event is something that happens to a record, such as a purchase order (PO) being added or approved. An outgoing event means Superwise tells the client when it happens. An incoming event means the client tells Superwise, for example to add a record.

Use this book when you want to start sharing records with another system. Integrations need technical details from the other system, such as its web address and how it checks who you are. Ask the person who looks after that system to give them to you.

![The list of integration clients. The mark 1 is the button Add.](../media/integration-client-list.png)

## Before you start

- Get from the other system: its base web address and its way of signing you in.
- Get its rate limit. This is the request limit the other system gives you.
- Have the logo of the other system as an image file smaller than 100 kb.
- Choose a Superwise user that the integration acts as. See [Users](../general/user.md).

## The steps in order

1. Add the client. See [Integration clients](clients.md).
2. Choose the events to share. This is step 2 of the client form. See [Integration clients](clients.md#how-to-add-an-integration-client).
3. Change how the data is mapped for an event, if needed. See [Integration events](events.md).
4. Switch the client to **Active**. See [Integration clients](clients.md#how-to-switch-a-client-on-or-off).
5. Check the results in the event log. See [Event log](event-log.md).

## What each screen is for

| Screen | What you do there |
| --- | --- |
| **Integration Clients** | Add the other systems, choose their events and switch them on or off. |
| **Events** (inside a client) | Change the web address and the mapping of one event. |
| **Event Log** | See what was sent and received, and send records that were never sent. |

![The page Event Log with the tab Logs. The mark 1 is the tab Logs, the mark 2 is a search box and the mark 3 is the button Reload Logs.](../media/integration-event-log.png)

## Rules to know

- A client name must be new in your company.
- You cannot choose the same operation of the same area as both an incoming and an outgoing event of one client.
- The Event Log is in the project menu, under **Integration**. The other screens are under **Company settings**.

## Related pages

- [Integration clients](clients.md)
- [Integration events](events.md)
- [Event log](event-log.md)
- [Users](../general/user.md)