Documentation Index
Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
Use this file to discover all available pages before exploring further.
ServiceNow
Connect your ServiceNow ITSM platform to enable CloudThinker agents to manage incidents, change requests, problems, and CMDB configuration items.Supported Platforms
| Platform | Support |
|---|---|
| ServiceNow | Xanadu, Yokohama, and newer releases |
| ServiceNow ITSM | All editions |
| ServiceNow ITOM | All editions |
ServiceNow supports N and N-1 releases. Older releases (Washington DC, Vancouver, etc.) are end-of-life. CloudThinker uses the ServiceNow REST API which is stable across all recent releases.
Setup
- Developer Instance
- Enterprise Instance
Connection Details
| Field | Description | Example |
|---|---|---|
| SERVICENOW_INSTANCE_URL | Your ServiceNow instance URL | https://your-instance.service-now.com |
| SERVICENOW_USERNAME | ServiceNow username | cloudthinker |
| SERVICENOW_PASSWORD | ServiceNow password | your-secure-password |
Required Permissions
Developer Instance
No additional configuration needed — the default admin user has full access.Enterprise Instance
| Role | Access |
|---|---|
itil | Full CRUD on incidents, changes, problems, and other ITSM task tables |
cmdb_read | Read-only access to CMDB configuration items |
rest_api_explorer | REST API access |
Agent Capabilities
Once connected, agents can:| Capability | Description |
|---|---|
| Incident Management | Create, update, and resolve incidents |
| Change Requests | Create and review change requests with risk assessment |
| Problem Management | Track and analyze problem records |
| CMDB Queries | Query configuration items and dependencies |
| User & Group Lookup | Find users, groups, and their assignments |
| Natural Language Search | Search across any ServiceNow table |
Example Prompts
Troubleshooting
Connection refused
Connection refused
- Verify the ServiceNow instance URL is correct and accessible
- Check the instance is not in maintenance mode
- Ensure no IP restrictions are blocking CloudThinker
Authentication failed
Authentication failed
- Verify username and password are correct
- Check the user account is active and not locked
- Ensure the user has
rest_api_exploreror equivalent API access role
Permission denied on table
Permission denied on table
- Verify the user has the required roles for the table being accessed
- Check ACL rules allow the user to read/write the table
- For CMDB access: ensure
cmdb_readrole is assigned
Rate limiting
Rate limiting
- ServiceNow may throttle API requests under heavy load
- Reduce concurrent operations if you see 429 errors
- Contact your ServiceNow admin to review rate limit settings
Security Best Practices
- Dedicated user - Create a dedicated ServiceNow user for CloudThinker
- Minimal roles - Grant only the roles needed for your use case
- Password rotation - Rotate passwords every 90 days
- IP restrictions - Consider limiting API access to CloudThinker IPs
- Audit trail - Enable and review ServiceNow system logs for the CloudThinker user
Related
PagerDuty Connection
Incident management and on-call
Elasticsearch Connection
Correlate logs with ServiceNow incidents