Copy page

Tailscale

Device Inventory

Monad uses the cron field to run this input on specific intervals and returns all devices' details, performing a full sync of data each time.

Sync Type: Full Synchronisation

Requirements

• Before you connect Monad to Tailscale, you need access to your Tailscale account.
• This connection requires an OAuth Client to be created.
• Instructions Here.
  • Open the OAuth clients page of the admin console.
  • In the Generate OAuth client page, Select devices:core scope.
  • Select Generate client.
  • In the Generated new OAuth client page, you can see the new OAuth client's ID and secret. Copy both the client ID and secret, as you need them to create the input in Monad. Note that after you close the Generated new OAuth client page, you won't be able to copy the secret again.
  • Select Done.
• Your OAuth client is now configured. Use the client ID and secret when you configure your Monad input.
• You can view your Organization name in the Settings page of the admin console. Leave the field blank if you want devices from default organization.

Details

Monad uses the cron field to run this input on specific intervals and returns all devices' details, performing a full sync of data each time.

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
Tailscale Organization ID	string	Yes	Your Tailscale Organization Name.
Field Option	string	Yes	Default return all fields except: enabledRoutes, advertisedRoutes, clientConnectivity
Cron	string	Yes	A cron expression defining how often to fetch user data.
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 for the field format, limits, and how to choose a value.

Secrets

Secret	Type	Required	Description
Client ID	string	Yes	Your Tailscale oauth Client ID.
Client Secret	string	Yes	Your Tailscale oauth Client Secret.

Related Articles

• https://tailscale.com/api#description/overview
• https://tailscale.com/api#tag/devices/GET/tailnet/[tailnet]/devices

Sample Record

Code
{
  "addresses": [
    "10.77.49.81",
    "fd7a:115c:a1e0::cd01:671b"
  ],
  "id": "327339287115191",
  "nodeId": "sample-node-id",
  "user": "",
  "name": "Supercomputer.nulla.ts.net",
  "hostname": "Smartphone.adipiscing",
  "clientVersion": "1.58.2-tb0e1bbb62",
  "updateAvailable": "true",
  "os": "linux",
  "created": "2025-08-11T23:46:52Z",
  "lastSeen": "2025-08-11T23:46:52Z",
  "keyExpiryDisabled": "true",
  "expires": "2025-08-11T23:46:52Z",
  "authorized": "false",
  "isExternal": "false",
  "machineKey": "mkey:sample_hash",
  "nodeKey": "nodekey:sample_hash",
  "tailnetLockKey": "nlpub:sample_hash",
  "blocksIncomingConnections": "true",
  "enabledRoutes": [],
  "advertisedRoutes": [],
  "clientConnectivity": {
    "endpoints": [
      "71.34.176.201:3729",
      "[2600:1700:51c0:bdaf:5c4d:944a:6e78:1abe]:51831",
      "10.70.29.120:46545"
    ],
    "mappingVariesByDestIP": true,
    "latency": {},
    "clientSupports": {
      "hairPinning": null,
      "ipv6": true,
      "pcp": false,
      "pmp": false,
      "udp": true,
      "upnp": false
    }
  },
  "tags": [
    "tag:Tablet"
  ]
}

Sync frequency

This input runs on a cron schedule (default hourly, 0 * * * *), which you can configure on the pipeline. See Input Sync Frequency for details.