Get customer by external ID

//native

type Kustomer = {

  apiKey: string;

};

/**

 * Get customer by external ID

 * Retrieves a customer based on their unique external ID.

The `externalId` is typically the ID of the customer within your database or an external service.

This provides a unique way to create and identify users by mapping a unique customer ID in Kustomer to a unique customer ID in an external system.

Any one of the following roles is required for this endpoint:

|Legacy Role|Equivalent Permission Set Role|

|-----|--------|

|org.user.customer.read|org.permission.customer.read|

 */

export async function main(auth: Kustomer, externalId: string) {

  const url = new URL(

    `https://api.kustomerapp.com/v1/customers/externalId=${externalId}`,

  );

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.apiKey,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}