# Activity Logs

**Sync Type: Incremental**

## Overview
The Polymer Activity Logs connector retrieves audit and activity data from your Polymer account, providing visibility into user actions,
authentication events, and system activities. This connector enables continuous monitoring and compliance tracking by ingesting
activity logs from the Polymer runtime data security platform.

## Prerequisites

### 1. Active Polymer account
You must have an active Polymer account with administrative access to retrieve API credentials and configure the connector.

#### Required Permissions
- Access to Organisation settings.
- Ability to generate and view API keys.
- Domain management access.

## Setup Instructions
### Retrieve Credentials
1. **Access Organisation settings**
   - From the Polymer Hub platform home page, click on your username in the bottom left corner.
   - Select Organization settings from the dropdown menu.

2. **Get Your API Token**
   - In the left navigation panel, select **API Key**.
   - Copy the API key value displayed on the screen

**Note** - Store this key securely - it will be used to authenticate all the API requests.

3. **Get Your Domain Name**
   - In the left navigation panel, select Domains.
   - Note the domain name listed (e.g., company.polymerhq.io or custom domain).
   - You'll use the subdomain portion (e.g., company) for configuration.

    #### Example
    - Full domain: acme-corp.polymerhq.io.
    - Domain name to use: acme-corp

## Configuration

### Settings

| Setting | Type | Required | Description |
|---------|------|----------|-------------|
| Domain Name | string | No | The subdomain from your Polymer organization URL (e.g., company from company.polymerhq.io). Retrieved in the Getting the Domain Name section. |
| API Rate Limit | object | No | Optional limit on the connector's outbound request rate to the source API. Leave blank to use the connector's default behavior. See [API Rate Limiting](../../../guides/rate-limiting) for the field format, limits, and how to choose a value. |

### Secrets

| Secret | Type | Required | Description |
|---------|------|----------|-------------|
| API Token | string | true | API key to authenticate requests to the Polymer API. Retrieved in the Retrieve API Token section. |

## Connector Limitations
1. The API allows a maximum of 120 requests per minute.
2. Pagination size is 20, so if the audit logs contain 3000 records, 150 API requests will need to be made, meaning this connector will slow down over time.

## Related Articles

- [Polymer](https://polymerhq.io)
- [Polymer - Docs](https://support.polymerhq.io/hc/en-us/categories/11648812899483-Documentation)

## Sample Record

```json
{
    "id": 2123221,
    "user": "jacob.sams@test.com",
    "role": "Admin",
    "activity": "Logged in",
    "created_at": "2022-10-02T17:09:55+00:00"
}
```

## Sync frequency

By default this input polls approximately every 10 seconds, with each sync beginning after the previous one completes. A cron schedule configured on the pipeline overrides this cadence. See [Input Sync Frequency](../../guides/sync-frequency) for details.