Workiva Activity Logs

Ingests activity logs from Workiva to track user actions and system events across your organization. This input captures comprehensive audit trail data including file access, user authentication, workspace modifications, permission changes, and other security-relevant activities.

Sync Type: Incremental

Requirements

Before you connect Monad to Workiva, you need to:

1. Create API Grant Credentials

   • Sign in to Workiva as an Org Security Administrator
   • Click your name in the bottom left to open the menu
   • Select Organization Admin → Security → Provisioning tab
   • Click Add Identity or API
   • From the dropdown, select API Grant
   • Enter a client name to identify the grant
   • Enter the Workiva username of the user who needs the grant
   • Set when the grant should expire based on your organization's security policies

2. Obtain Your Organization ID

   • Your organization ID can be found in the Workiva admin console
   • It's typically in the format of a UUID (e.g., 550e8400-e29b-41d4-a716-446655440000)

3. Retrieve the Client Secret

   • Only the user can view their grant's secret
   • Go to the Security tab in your user profile
   • Click the Regenerate option in the Actions dropdown next to the grant
   • Important: The secret can only be viewed once, so copy it immediately to a secure location
   • Never commit credentials to source code

4. Required Permissions

   • The API grant must be associated with an account that has access to view organization activities
   • Typically requires Organization Admin or Security Admin role

Configuration

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

Settings

Setting	Type	Required	Description
Organization ID	string	Yes	The Workiva organization ID to fetch activity logs from
Backfill Start Time	string	No	The date to start fetching data from. If not specified, will fetch from the most recent data available.
Client ID	string	Yes	OAuth2 Client ID for authenticating with Workiva

Secrets

Secret	Type	Required	Description
Client Secret	string	Yes	OAuth2 Client Secret for authenticating with Workiva

Troubleshooting

Authentication Errors

• Verify that your Client ID and Client Secret are correct
• Ensure the API grant hasn't been revoked or expired in Workiva
• Confirm that the user associated with the grant has necessary permissions
• Check that the Organization ID is correct

No Activities Retrieved

• Verify that activities exist for your organization within the specified date range
• Ensure the backfill start time is in a valid date format (RFC3339: 2024-01-01T00:00:00Z)
• Confirm that the user account has permissions to view organization activities
• Check that the Organization ID is correct

Rate Limit Errors (429)

• The connector implements automatic retry with exponential backoff
• If you consistently hit rate limits, consider adjusting your sync frequency
• Contact Workiva support if you need higher rate limits

Connection Timeout

• Verify network connectivity to https://api.app.wdesk.com
• Ensure firewall rules allow outbound HTTPS traffic
• Check that the Workiva API is not experiencing an outage

Related Articles

• Workiva API Authentication
• Workiva API Setup Guide
• View Organization Activities in Workiva
• Workiva Activities API

Sample Record

{
  "action": {
    "alias": "workspace_membership_create",
    "category": "Administration",
    "deprecated": false,
    "id": "com.workiva.administration.workspace_membership.create",
    "name": "Workspace membership created",
    "type": "com.workiva.administration.workspace_membership.create"
  },
  "activityDateTime": "2021-01-30T13:55:01Z",
  "description": "Adam Admin added the user 'John Public' to the workspace 'Organization Management'",
  "id": "NjE0MjIxODItOTVkYi00YmFjLWI4ZjktNzRkMDg1OTdlMDgwOlFYVmthWFJNYjJjZVFYVmthWFJNYjJjNk5ETXpaamN4TUdVMU5HRTBOR1V5Tm1JeU5ERmtOREJsWXpNMlpHWXhNVFE=",
  "organization": {
    "id": "d6e178fd-4dd5-47e5-9457-68dd64b03655",
    "name": "Workiva Inc."
  },
  "outcome": "success",
  "performer": {
    "displayName": "Adam Admin",
    "id": "V0ZWc2VyHzE0NT8xNzAyMDA",
    "ipAddress": "192.168.1.1",
    "type": "com.workiva.iam.principal.user",
    "uniqueName": "admin_admin@example.com"
  },
  "tags": [
    "correlationId:1a2b3c4d5e6f000db88c0009f9f1",
    "eventId:LM4s-wJyTgW4NTbNZi_86v"
  ],
  "targets": [
    {
      "displayName": "John Public",
      "id": "V0ZVc2VyHzY0ODY4NjQ1MzE1NTQ",
      "type": "com.workiva.administration.user",
      "uniqueName": "john_public"
    }
  ],
  "workspace": {
    "id": "QWNjb3VudB81NjM5NDQ1NjA0NzI4ODMy",
    "name": "Organization Management"
  }
}