The following guidance will walk you through the processes involved with linking your InBody Account to Heads Up Health via our Web API Integration.


InBody side requirements:

InBody

1. Do you have an LB Web account?

Please note that the API is a paid service and an active subscription is required.

2. Submit API application form "https://inbodyusa.com/api-application-af/"

3. Once approved, log into API site "https://apiusa.lookinbody.com"

4. After logging in, navigate to 'SETUP' and follow the guided steps:



Step 1. Select 'Get a New Key' to Generate your API Key




Step 2. Please contact your Application Developer to obtain their server IP Address, some may have, some may not.



Step 3. Configure your webhook with the details from your Heads Up Health Platform, please see below.


In order to have data sync immediately going forward, we need to configure a webhook that InBody can use to tell Heads Up that there is new data. 

  1. With your newly connected account in Heads Up, copy the Webhook URL:

  2. Navigate back to LookInBody Web and paste the Webhook URL from Heads Up into the InBody platform

  3. After pasting in the Webhook URL, input "User-Agent" into Key 1 and "InBody" into Value 1

  4. Click "Send Test" and wait for a Success response


If you run into any problems, please contact LBsupport@InBody.com for assistance.


Heads Up Health side requirements:


Link Your InBody Account in Heads Up

  1. Go to your Organization Settings > Integrations

  2. Find InBody in the list and click Link

  3. Paste in your API Key and Account ID from Step 1

  4. Click Save

 

 

 


Heads Up Health related FAQ



Match Clients via Phone Number

Heads Up and InBody match users using their phone numbers. To ensure a successful sync:

  • Make sure each user has a phone number in both systems

  • The number must match exactly (area code included!)

Where to set phone numbers:

  • During Registration:

  • Existing Users:

    • Go to the client’s Profile

    • Add a Primary or Secondary Phone Number

 

What Happens Next?

Once InBody returns data for a matching phone number, the results will automatically show up in the client’s Heads Up Lab Results section.

How the Syncing Works

There are two scenarios that affect how data syncing is handled when using device a client’s phone number:

1. When a client’s phone number is updated:

  • We immediately sync the most recent data for that client.

  • A background job is then triggered to sync the historical data.

  • This process is the same as what happens when initially building a connection.

  • If the client belongs to many organizations, we sync each integration one by one — which may delay the full sync process.

2. When an organization connects a new integration:

  • We check all clients to identify any that use supported device identifiers.

  • We only trigger a background job to sync historical data.

  • We do not sync the most recent data immediately, to avoid performance issues in cases where many clients are involved.


Reference material on Heads Up Health: How do I connect my organization’s InBody account to Heads Up? | Heads Up Health Help Center 


If you need to reach the Heads Up Health Team directly, their support team can be reached via support@headsuphealth.com