Client Setup

How to configure the NexudusApiClient with authentication and connection options.

Client Setup

The NexudusApiClient is the central object you use to interact with the Nexudus API. It requires an HttpClient, an authentication provider, and an optional configuration object.

Basic setup

using Nexudus.Sdk;
using Nexudus.Sdk.Auth;
using Nexudus.Sdk.Configuration;

var auth = new BasicAuthProvider("[e-mail]", "password");

using var client = new NexudusApiClient(new HttpClient(), auth);

Configuration options

Pass a NexudusOptions object to customise the client behaviour:

var options = new NexudusOptions
{
    BaseUrl = "https://spaces.nexudus.com", // Default
    PageSize = 25,                          // Default page size for listings
    Timeout = TimeSpan.FromSeconds(30)      // HTTP request timeout
};

using var client = new NexudusApiClient(new HttpClient(), auth, options);

Option	Type	Default	Description
BaseUrl	string	https://spaces.nexudus.com	The Nexudus API base URL.
PageSize	int	25	Default number of records per page.
Timeout	TimeSpan	30 seconds	HTTP request timeout.

Using environment variables

For scripts and CI/CD pipelines, store credentials in environment variables instead of hard-coding them:

var email = Environment.GetEnvironmentVariable("NEXUDUS_EMAIL")
    ?? throw new InvalidOperationException("NEXUDUS_EMAIL not set");
var password = Environment.GetEnvironmentVariable("NEXUDUS_PASSWORD")
    ?? throw new InvalidOperationException("NEXUDUS_PASSWORD not set");

var auth = new BasicAuthProvider(email, password);
using var client = new NexudusApiClient(new HttpClient(), auth);

Set the variables before running your app:

PowerShell

$env:NEXUDUS_EMAIL = "[e-mail]"
$env:NEXUDUS_PASSWORD = "your-password"

Bash

export NEXUDUS_EMAIL="[e-mail]"
export NEXUDUS_PASSWORD="your-password"

Never commit credentials to source control. Use environment variables, user secrets, or a vault for production deployments.

Entity endpoints

Once you have a client, create endpoint instances for the entities you need:

var coworkers  = new CoworkerEndpoint(client);
var bookings   = new BookingEndpoint(client);
var products   = new ProductEndpoint(client);
var businesses = new BusinessEndpoint(client);

There are 200+ endpoint classes available — one for every entity type in the Nexudus API. They all expose the same set of methods described in the following pages.