Create table record

Overview

Creates a single record in the specified table.

note

This endpoint doesn't support bulk insertion.

Path parameters

Name	Description
table	The table name for the operation.

Optional query parameters

Name	Type	Possible values	Description
DisplayValue	tableapi.DisplayValue	DisplayValueTrue, DisplayValueFalse, or DisplayValueAll	Determines the type of data returned, either the actual values from the database or the display values of the fields.
ExcludeReferenceLink	bool	N/A	Flag that indicates whether to exclude Table API links for reference fields.
Fields	[]string	N/A	List of fields to include in the response.
InputDisplayValue	bool	N/A	Flag that indicates whether to set field values using the display value or the actual value.
View	tableapi.View	ViewDesktop, ViewMobile, or ViewBoth	UI view for which to render the data.

Required query parameters

N/A

Examples

Fluent

package main

import (
	"context"
	"fmt"
	"log"

	servicenowsdkgo "github.com/michaeldcanady/servicenow-sdk-go/v2"
	tableapi "github.com/michaeldcanady/servicenow-sdk-go/v2/tableapi"
)

func main() {
  // Step 1: Create credentials
  cred := credentials.NewBasicProvider("{username}", "{password}")

  // Step 2: Initialize client
  client, err := servicenowsdkgo.NewServiceNowServiceClient(
  	servicenowsdkgo.WithAuthenticationProvider(cred),
  	servicenowsdkgo.WithURL("https://{instance}.service-now.com"),
  )
  if err != nil {
  	log.Fatal(err)
  }
  // Step 3: Configure request
  createConfig := &tableapi.TableRequestBuilderPostRequestConfiguration{
  	QueryParameters: &tableapi.TableRequestBuilderPostQueryParameters{
  		// Optional configurations
  	},
  }

  // Step 4: Build request body
  createData := tableapi.NewTableRecord()
  if err := createData.SetValue("short_description", "example incident"); err != nil {
  	log.Fatal(err)
  }
  if err := createData.SetValue("description", "incident created by servicenow-sdk-go"); err != nil {
  	log.Fatal(err)
  }

  // Step 5: Execute request
  createResponse, err := client.Now().Table("{TableName}").Post(context.Background(), createData, createConfig)
  if err != nil {
  	log.Fatal(err)
  }
}

Standard

package main

import (
	"context"
	"fmt"
	"log"

	servicenowsdkgo "github.com/michaeldcanady/servicenow-sdk-go/v2"
	tableapi "github.com/michaeldcanady/servicenow-sdk-go/v2/tableapi"
)

func main() {
  // Step 1: Create credentials
  cred := credentials.NewBasicProvider("{username}", "{password}")

  // Step 2: Initialize client
  client, err := servicenowsdkgo.NewServiceNowServiceClient(
  	servicenowsdkgo.WithAuthenticationProvider(cred),
  	servicenowsdkgo.WithURL("https://{instance}.service-now.com"),
  )
  if err != nil {
  	log.Fatal(err)
  }
  // Step 3: Define raw URL
  rawURL = "https://{instance}.service-now.com/api/now/v1/table/{TableName}"

  // Step 4: Build request
  collectionRequestBuilder = tableapi.NewDefaultTableRequestBuilder(rawURL, client.GetRequestAdapter())
  // Step 5: Configure request
  createStdConfig := &tableapi.TableRequestBuilderPostRequestConfiguration{
  	QueryParameters: &tableapi.TableRequestBuilderPostQueryParameters{
  		// Optional configurations
  	},
  }

  // Step 6: Build request body
  createStdData := tableapi.NewTableRecord()
  if err := createStdData.SetValue("short_description", "example incident"); err != nil {
  	log.Fatal(err)
  }
  if err := createStdData.SetValue("description", "incident created by servicenow-sdk-go"); err != nil {
  	log.Fatal(err)
  }

  // Step 7: Execute request
  createStdResponse, err := collectionRequestBuilder.Post(context.Background(), createStdData, createStdConfig)
  if err != nil {
  	log.Fatal(err)
  }
}