Skip to main content

User Directory

Returns a list of all users, including active users, inactive users and previously deleted users that have an Atlassian account, associated with your Jira site.

Sync Type: Full Synchronisation

Requirements​

Before you connect Monad to Jira, you need an API token, email, and a domain:

  1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.

  2. Select Create API token.

  3. Give your API token a name that describes what it does.

  4. Select an expiration date for the API token.

  5. Token expiration is 1 to 365 days*

  6. Select Create.

  1. Select Copy to clipboard, then paste the token to your script, or save it somewhere safe.

  2. Your domain name is the unique subdomain of your Jira instance. If your Jira URL is 'acme.atlassian.net', then 'acme' is the domain name.

  3. The email address is the one associated with your Atlassian account used to access Jira.

*Note: When generating an API Token, please be mindful of its expiry date, as the token and its expiry is not generated by Monad. If the token expires, any inputs relying on it will result in errors. To continue, you will need to regenerate a new API Token through the UI.

Details​

Monad uses the cron field to schedule the input at specific intervals, returning all users, including active users, inactive users and previously deleted users that have an Atlassian account. A full data sync is performed each time.

Configuration​

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

Settings​

SettingTypeRequiredDescription
EmailstringYesThe email address associated with your Atlassian account used to access Jira.
DomainstringYesThis is the unique subdomain of your Jira instance. If your Jira URL is 'acme.atlassian.net', then 'acme' is the domain name.
CronstringYesCron expression for scheduling the input.

Secrets​

SecretTypeRequiredDescription
Api TokenstringYesThis is the token you generate from your Atlassian account for API access.

https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#about https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-users-search-get

Sample Record​

{
  "accountId": "9f50e6c78g634a9b44ihg65k",
  "accountType": "atlassian",
  "active": false,
  "avatarUrls": {
    "16x16": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AB-9.png?size=16&s=16",
    "24x24": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/GH-6.png?size=24&s=24",
    "32x32": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/IJ-6.png?size=32&s=32",
    "48x48": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AB-8.png?size=48&s=48"
  },
  "displayName": "Jane Johnson",
  "key": "",
  "name": "",
  "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=9f50e6c78g634a9b44ihg65k"
}