# Partner Connections

Partner Connections let you establish secure, managed relationships between your organization and external business partners within AccessIQ.

> **Beta:** This feature is currently in beta. Functionality and configuration options may change.

## What Are Partner Connections?

A partner connection links your AccessIQ tenant with an external organization. Once connected, you can:

* Grant partner users controlled access to your applications
* Share specific data or resources with the partner
* Manage partner user permissions from your admin dashboard
* Track partner activity in audit logs

## Creating a Connection

### Step 1: Invite a Partner

1. Go to **B2B > Connections**.
2. Click **Add Connection**.
3. Enter the partner details:

| Field           | Description                                                                          |
| --------------- | ------------------------------------------------------------------------------------ |
| Partner name    | The partner organization's name                                                      |
| Contact email   | Primary contact at the partner organization                                          |
| Connection type | Inbound (they access your resources), Outbound (you access theirs), or Bidirectional |
| Message         | Optional note included in the invitation                                             |

4. Click **Send Invitation**.

### Step 2: Partner Accepts

The partner receives an email invitation with a link to accept the connection. They can:

* Accept and link their existing AccessIQ tenant
* Accept and create a new AccessIQ tenant
* Decline the invitation

### Step 3: Configure Access

Once the connection is accepted:

1. Go to the connection detail page.
2. Under **Access**, choose which applications and resources the partner can access.
3. Assign a default role for partner users.
4. Optionally, set an expiration date for the connection.

## Connection Status

| Status    | Meaning                                        |
| --------- | ---------------------------------------------- |
| Pending   | Invitation sent, waiting for partner to accept |
| Active    | Connection is established and operational      |
| Suspended | Temporarily disabled by either party           |
| Expired   | Connection has passed its expiration date      |
| Revoked   | Permanently terminated                         |

## Managing Connections

### Suspend a Connection

Temporarily disable a connection without deleting it. Partner users lose access immediately but the configuration is preserved.

1. Open the connection and click **Suspend**.
2. To restore, click **Reactivate**.

### Revoke a Connection

Permanently end the partnership. All partner access is removed.

1. Open the connection and click **Revoke**.
2. Confirm the action. This cannot be undone.

## Monitoring Partner Activity

All partner user actions are recorded in the [Audit Logs](/accessiq-docs/audit-and-compliance/audit-logs.md). Filter by the partner organization to review their activity.

## Best Practices

* Use the principle of least privilege when granting partner access.
* Set expiration dates on connections that are project-based or time-limited.
* Review partner activity in audit logs regularly.
* Suspend rather than revoke connections when you may need to restore access later.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://accessiq.gitbook.io/accessiq-docs/b2b-and-partners/connections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.