> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seyaha.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Manage your partner account, integration credentials, team access, and notifications.

Access **Settings** from the bottom of the left sidebar. The page is organized into
four sections: **Profile**, **Integration**, **Team**, and **Notifications**.

## Profile

### Organization details

| Field                     | Description                                             |
| ------------------------- | ------------------------------------------------------- |
| **Business name**         | Your legal trading name                                 |
| **Business type**         | Tour operator, guide, museum, experience provider, etc. |
| **Primary contact name**  | Main point of contact at your organization              |
| **Primary contact email** | Receives all account and integration notifications      |
| **Phone number**          | Contact number for your organization                    |
| **Logo**                  | PNG or SVG, recommended 400×400 px                      |
| **Description**           | Short description visible to Seyaha admins              |

Click **Save changes** after updating any field.

### Password

1. Click **Change password**
2. Enter your current password
3. Enter and confirm your new password (minimum 8 characters)
4. Click **Update password**

## Integration

### API configuration

This section shows the credentials you submitted during registration and the current
integration status.

| Field             | Description                                                |
| ----------------- | ---------------------------------------------------------- |
| **Base URL**      | Root URL of your OCTO API                                  |
| **Auth type**     | `bearer` or `api_key`                                      |
| **Auth key**      | The credential Seyaha sends in every inbound request       |
| **Status**        | `Active`, `Pending approval`, or `Suspended`               |
| **Last verified** | Timestamp of the most recent successful connectivity probe |

#### Updating your credentials

To update the **Base URL** or rotate your **Auth key**:

1. Deploy the new endpoint or credential to your server first
2. Update the field in the dashboard
3. Click **Save integration**

Seyaha immediately probes `GET /products?limit=1` using the new values to verify connectivity.
The integration is only saved if the probe returns a `2xx` response.

<Warning>
  Changes take effect immediately. Any sync or booking request in flight at the moment
  you save will use the old credentials. If you must rotate during active traffic,
  accept both the old and new key on your server briefly during the transition.
</Warning>

### Webhook secret

Your webhook secret authenticates inbound sync trigger calls from your system to Seyaha.
It was shown once when your integration was first created.

**If you have lost your webhook secret:**

1. Click **Regenerate secret**
2. Read the warning — the old secret is invalidated immediately
3. Confirm the action
4. Copy the new secret and store it securely before closing the modal

<Note>
  The webhook secret is stored hashed by Seyaha and cannot be retrieved after initial display.
  Always copy it immediately when generated.
</Note>

### Sync schedule

The **Sync** panel shows:

* **Next scheduled sync** — when the next nightly sync will run
* **Last sync** — outcome and timestamp of the most recent sync
* **Sync frequency** — contact `tech@seyaha.net` to change the default nightly schedule

To trigger an immediate sync, use **Sync now** on the Products page or call the
trigger endpoint from your system — see [Sync & Webhooks](/pages/partner/sync).

## Team

Add colleagues who need access to the partner portal.

### Inviting a team member

1. Click **Invite member**
2. Enter their email address
3. Select a role:
   * **Admin** — full access including settings and credentials
   * **Manager** — can view and manage bookings and products, cannot change integration settings
   * **Viewer** — read-only access to all sections
4. Click **Send invitation**

The invitee receives an email with a link to set their password and join your organization.
Invitations expire after 72 hours. Resend from the **Pending** tab if needed.

### Managing team members

| Action            | How                                                            |
| ----------------- | -------------------------------------------------------------- |
| Change role       | Click the role badge on a member's row and select the new role |
| Remove member     | Click **···** on the row and select **Remove**                 |
| Resend invitation | Click **···** on a pending invite and select **Resend**        |

## Notifications

Configure which events send email notifications to your primary contact email:

| Event                                       | Default |
| ------------------------------------------- | ------- |
| New booking received                        | On      |
| Booking cancelled                           | On      |
| Sync completed successfully                 | Off     |
| Sync failed                                 | On      |
| Integration status changed (e.g. suspended) | On      |
| New team member joined                      | On      |

Toggle each event and click **Save preferences** to apply.

To send notifications to a different email than your primary contact, click
**Add notification email** and enter the address. Notification emails cannot log in
to the portal — they only receive emails.