michaeldcanady / servicenow-sdk-go

A Service-Now API client enabling Go programs to interact with Service-Now in a simple and uniform way

ServiceNow SDK for Go

A Service-Now API client enabling Go programs to interact with Service-Now in a simple and uniform way

Supported Service-Now APIs

API	Status	Issues
Account	✖️
ActivitySubscriptions	✖️
Agent Client Collector	✖️
Aggregate	✖️
AI Search External User Mapping	✖️
Alarm Management Open	✖️
Application Service	✖️
Appointment	✖️
Attachment	♻️
Advanced Work Assignment (AWA) Agent	✖️
AWA Assignment	✖️
AWA Routing	✖️
Batch	✖️
Case	✖️
Custom Chat Chatbot Interoperability Framework (CCCIF) Media Resource	✖️
CdmApplicationsApi	✖️
CdmChangesetsApi	✖️
CdmEditorApi	✖️
CdmPoliciesApi	✖️
Tables	✔️

---

Emoji	Meaning
✔️	Supported
🆕	Preview
♻️	In progress
✖️	Not supported

1. Installation

Install latest

go get github.com/michaeldcanady/servicenow-sdk-go

or

Install specific version

go get github.com/michaeldcanady/servicenow-sdk-go@version

2. Getting Started

2.1 Create an AuthenticationProvider object

Create a credential object.

import (
    "github.com/michaeldcanady/servicenow-sdk-go/credentials"
)

cred := credentials.NewUsernamePasswordCredential("username", "password")

2.2 Get a ServiceNow Client and Adapter object

Create a client object.

import (
    servicenowsdkgo "github.com/michaeldcanady/servicenow-sdk-go"
)

client := servicenowsdkgo.NewServiceNowClient(cred, "instance")

2.3 Get query parameters

Build query parameter object.

import (
    "github.com/michaeldcanady/servicenow-sdk-go/table-api"
)

params := &tableapi.TableRequestBuilderGetQueryParameters{
        Limit: int32(1),
    }

2.4 Build request for table

Formulate request and provide parameters.

records, err := client.Now().Table("table name").Get(params)
if err != nil {
    panic(err)
}