Integrations

The Integrations hub in the Admin Panel is where administrators connect PetroBench to corporate data systems and open the API Console for the organization.

Open Integrations

1. Switch to Admin Panel
2. Open API & Integrations > Overview (label may show as Integrations)
3. Review featured connectors and category lists (Oil & Gas, Cloud & Data, Identity & Access, and related groups)

The hub shows totals for available and connected integrations when your org has access.

What you manage here

Personal API tokens and Connected apps live under Settings. The Admin Panel hub is the organization-level developer surface.

EventHub and warehouse sync

For EventHub, Snowflake, and related sync workflows, use the Enterprise guides:

• Integrations overview
• Getting started with the API

From the Admin Panel you typically:

1. Open the connected integration card
2. Review field mappings, sync schedule, and recent sync logs
3. Resolve equipment match reviews when the connector queues low-confidence matches

On an individual synced well, engineers can View source data, Re-pull from source, or Reset from last sync. See EventHub on a Well.

API Console

API Console is the in-app home for organization API access. Open Admin Panel > API & Integrations > API Console.

It includes four tabs:

Usage

Usage shows API request volume, quotas, and token consumption for the current period.

Typical cards include:

• Organization and personal request counts, average response time, and error rate
• Plan limits - requests per minute, division aggregate, concurrent runs, daily token ceiling
• Monthly quotas - reads, writes, simulation runs, and webhook deliveries
• Daily activity plus top endpoints and consumers when traffic exists

Use this tab when diagnosing rate limits, quota pressure, or unexpected API errors. See also Rate limits.

Service Tokens

Service Tokens are long-lived credentials owned by the division, not a person. They keep working after the creator leaves.

Create a service token

1. Go to Admin Panel > API & Integrations > API Console
2. Open the Service Tokens tab
3. Click Create service token
4. Enter a Token name (for example, Nightly Snowflake Sync)
5. Choose an Expiration (30 days, 90 days, or 1 year)
6. Optionally set an IP allowlist
7. Select Permissions (scopes) for Wells, Simulations, Equipment, and Organization
8. Click Create service token
9. Copy the plaintext token immediately - it is shown only once

From the row menu you can rename, rotate, or revoke a token. Each division has a capped number of active tokens (shown as used of total on the list).

Full auth details: API authentication.

Webhooks

Webhooks register HTTP endpoints that PetroBench calls when events occur (for example, well.created or simulation.failed).

1. Open the Webhooks tab
2. Click Add Webhook
3. Enter the endpoint URL and select events
4. Save, then use the send/test control to verify delivery

Connect

The Connect tab helps you point MCP clients (Claude, ChatGPT, Cursor), cURL, or Python at your workspace. Copy the config for your client, then replace the API key placeholder with a service token or personal key.

For step-by-step client setup, see Getting started and the MCP reference.

Who can access

Related

• Apps for installed applications and marketplace enablement
• Getting started with the API
• API authentication
• Rate limits
• RBAC for who can manage organization settings