Skip to content

Connection

A connection is a link between Dimdata and a 3rd party service or app. The OAuth 2.0 connection handles the token exchange automatically.

When working with the Dimdata APIs, your app will access Dimdata on behalf of your users. You'll need to have each user of your app sign into dimdata.com to grant your app permission to access their data on Dimdata.

Dimdata API is designed for application partners and customers.

Register your application

Note

Dimdata supports OAuth 2.0 only. Before you start configuring your OAuth2.0 connection, you need to register your application via https://app.dimdata.com/developer. If you don't have a registered application or your application status is waiting for approval, you can use Postman for development purposes and testing APIs by follow Getting Started guide below. You also need an Dimdata account with any plan to test as end-user consent.

Learn more API Reference

Getting Started development with Postman

Authorization and request access token with Postman

Field Description
Grant Type Authorization Code (With PKCE)
Callback URL https://oauth.pstmn.io/v1/callback (Authorize using browser)
Auth URL https://account.dimdata.com/connect/authorize
Access Token URL https://account.dimdata.com/connect/token
Client ID postmanapi
Code Challenge Method SHA-256
Code Verifier Blank (Automatic)
Scope email dimdataApi

Note

Scope offline_access is not allowed with this Client ID

Testing your authorization token by calling this API

GET https://webapi.dimdata.com/api/getuserinfo

Get customer account and user information

curl --location --request GET '/api/getuserinfo' \
     --header 'authorization: bearer [accesstoken]' \
Responses
200: OK Returns customer account and user information
400: Bad Request If customer not found