Skip to main content

Activity Logs

Collects and ingests activity logs from Figma, providing comprehensive visibility into user actions, file access, team changes, and administrative events within your Figma organization.

Sync Type: Incremental

Details​

This input collects activity logs from the Figma Activity Logs API, capturing critical activities including user authentication, file operations, team membership changes, permission modifications, and administrative actions. The input supports incremental sync with cursor-based pagination and state management to ensure only new events are collected on subsequent runs.

Prerequisites​

Before connecting Monad to Figma, you need:

  1. A Figma Enterprise plan (Activity Logs API is only available on Enterprise plan).
  2. Organization admin permissions to authorize the OAuth application.
  3. Access to the Figma organization whose activity logs you want to collect.

Setup Instructions​

1. Connect Your Figma Account​

  1. Navigate to Input Configuration:

    • In Monad, go to the Figma Activity Logs input configuration screen
    • You will see a Set up OAuth button to initiate the OAuth flow

  2. Authorize Monad:

    • Click the Set up OAuth button.
    • You will be redirected to Figma's authorization page.
    • Sign in with your Figma account if not already signed in.
    • Review the permissions being requested (specifically org:activity_log_read scope).
    • Click Allow access to grant Monad permission to access your organization's activity logs.

  3. Complete Authorization:

    • After granting access, you will be redirected back to input configuration screen.
    • OAuth Token secret field will be populated.

Note: Only organization administrators can authorize access to activity logs. Ensure you have the appropriate permissions before attempting to connect.

Configuration​

The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.

Settings​

SettingTypeRequiredDescription
Backfill Start TimestringNoThe date to start fetching data from. If not specified, no past records will be fetched.

Secrets​

SecretTypeRequiredDescription
OAuth ConnectionoauthYesOAuth2 connection established via the Set up OAuth button. This field will be populated on the completion of OAuth flow.

⚠️ Note: Access token generated after the OAuth connection while configuring Figma input has expiry of 90 days. After expiry the input will refresh the token automatically.⚠️

Sample Record​

{
  "action": {
    "details": {
        "permission": "member",
        "figma_paid_status": "viewer",
        "figjam_paid_status": "viewer"
    },
    "type": "org_user_delete"
  },
  "actor": {
    "email": "admin@figma.com",
    "id": "1099091282752443416",
    "name": "Admin",
    "type": "user"
  },
  "context": {
    "client_name": null,
    "ip_address": "172.19.0.1",
    "is_figma_support_team_action": false,
    "org_id": "1047918802483077121",
    "team_id": null
  },
  "entity": {
    "email": "member@figma.com",
    "id": "1099091282712783786",
    "name": "Member",
    "type": "user"
  },
  "id": "1243",
  "timestamp": 1650578182
}