Skip to main content
A JobDiva administrator or team leader account is required to create the API user. You will also need to contact JobDiva support to obtain your Client ID.

​
Obtain your Client ID

The Client ID is a unique numeric identifier assigned to your JobDiva account. It cannot be generated within the platform and must be requested from JobDiva support.

1

Contact JobDiva support

Send an email to support@jobdiva.com requesting your API Client ID.

  • Use a subject line such as: Request for API Client ID for third-party integration
  • Include your company name and JobDiva account details in the email.
  • JobDiva support will respond with your Client ID, which is a numeric value (e.g. 123456).
2

Save your Client ID

Once you receive the Client ID from JobDiva support, copy and store it securely. You will need it when connecting your account.

  • The Client ID is a number — do not confuse it with your username or password.
  • Paste it into the Client ID field when prompted.

​
Create a dedicated API user

JobDiva requires a separate user account specifically for API access. This account is different from your normal login credentials and should be used exclusively for integrations.

1

Sign in to JobDiva

Go to login.jobdiva.com and sign in with your administrator or team leader account.

2

Navigate to My Team settings

Once signed in, navigate to the team management area.

  • Click on Settings in the main navigation.
  • Select My Team from the settings menu.
3

Add a new user

Create a new user account that will serve as your dedicated API user.

  • Click Add User to create a new team member.
  • Enter a recognisable name for the API user (e.g. StackOne API User).
  • Set an email address for the account (this will be the API Username).
  • Set a secure password (this will be the API Password).
  • Save the user account.

​
Assign API-only permissions

The API user must be restricted to API access only. This ensures the account cannot be used to sign in to the JobDiva web interface directly.

1

Open user permissions

Locate the newly created API user in My Team and open their permissions settings.

  • Find the API user in the team member list.
  • Click on Assign User Permissions (or the permissions/edit option next to the user).
2

Enable API-only access

Configure the user so that they can only access the JobDiva API.

  • Select the permission Only allow access to JobDiva API Calls.
  • Ensure all other user permissions are deselected.
  • Save the permission changes.
  • Important: If this permission is not set, the API user may not be able to authenticate via the API.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Client ID
  • API Username
  • API Password
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup
If the account linking is successful, you will see the newly linked account in your Accounts page.