Extracting Employee Data with the BambooHR API - Practical Examples.

Apideck Documentation Page

How to Sign Up for a ServiceNow Developer Instance (for Apideck Integration)

To integrate ServiceNow with Apideck, you'll can set up a Personal Developer Instance (PDI) to obtain admin-level access and credentials. This instance serves as your sandbox environment for development and testing.

1. Create a ServiceNow Developer Account

  1. Visit: https://developer.servicenow.com
  2. Click: “Sign Up and Start Building”
  3. Fill in: Your name, email address, and password
  4. Accept: The terms and conditions
  5. Submit: Your registration
  6. Verify: Your email address by clicking the link in your inbox

Once verified, you'll have access to the ServiceNow Developer Dashboard.

2. Request a Personal Developer Instance (PDI)

  1. Log in to your ServiceNow Developer account
  2. Click: “Request Instance” in the top navigation
  3. Select: Your desired ServiceNow release (e.g., Washington DC)
  4. Click: “Request”

After a short provisioning process, you'll receive:

  • Instance URL — e.g., https://dev12345.service-now.com
  • Admin Username — admin
  • Temporary Password — shown upon provisioning

⚠️ Make sure to securely store the temporary password. You’ll need it to log in for the first time.

3. Access and Configure Your Instance

  1. Open your instance URL
  2. Log in with admin and the temporary password
  3. You’ll be prompted to change your password on first login

You now have full admin access to configure and develop within your personal ServiceNow instance.

⏳ Instances inactive for 10 days may be reclaimed and reset, resulting in data loss. To maintain Your Instance: Log in regularly to your instance and Perform any activity (e.g., open a table, make changes).

4. Configure the ServiceNow connector in Apideck

Enable the ServiceNow connector in the Apideck Admin. Go to the Apideck > Configuration > Issue Tracking > ServiceNow

5. Vault Connection Testing

Now that you have your ServiceNow connector configured, you can connect to your ServiceNow account in a secure manner. Select Use your ServiceNow client credentials and copy paste the Client ID and secret as documented in the connection guide.

You can start testing it by using the ServiceNow API via our Proxy API.

You can test the connection by clicking "Test Vault", which trigger the OAuth flow to give access to your ServiceNow account for the consumer with ID test-consumer.

5. Make your first API call

To test the access token, make a call to the ServiceNow API endpoint using the Proxy API to get a list of incidents.

curl --location --request POST 'https://unify.apideck.com/proxy' \
--header 'x-apideck-consumer-id: test-consumer' \
--header 'x-apideck-app-id: {APIDECK_APP_ID}' \
--header 'x-apideck-service-id: servicenow' \
--header 'x-apideck-downstream-url: https://{instance}.service-now.com/api/now/table/incident?sysparm_limit=1' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {APIDECK_API_KEY}' \

For more information, go to the Apideck ServiceNow connector documentation.