Getting started¶

Requirements¶

Installed golang 1.23+.
Active Service-Now instance or developer instance.

1. Install Service-Now SDK for Go¶

Install the latestInstall a specific version

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

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

2. Create a credential¶

package main

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

func main() {
    // instantiates a basic authentication username/password credential but you can use any from the `credentials` submodule or implement your own!
    cred := credentials.NewUsernamePasswordCredential("{username}", "{password}")
    ...
}

3. Create a Service-Now client¶

Specify instance

    client := servicenowsdkgo.NewServiceNowClient(cred, "{instance}.service-now.com")

Specify url

```golang
    client := servicenowsdkgo.NewServiceNowClient(cred, "{custom-url.com}")
```

4. Review specific api documentation¶

With the client object initialized, implementation of the full capabilities offered by the Service-Now SDK for Go can begin. Refer to apis for details on implementing specific APIs.