---
title: Engine Endpoint Configuration
slug: sdks/engine-endpoint-configuration
docTags: 
createdAt: 2026-04-21T08:01:31.236Z
---

## Overview

The SDK allows configuration of the engine endpoint using the `engineHostName` field in the `Account` object.

If not explicitly provided, the SDK automatically falls back to a default endpoint for optimal performance and routing.

##  Configuration

### Default Behavior

If `engineHostName` is not set, `null`, or `empty`, the SDK uses:

:::BlockQuote
engine.monetate.net
:::

### Custom Configuration

You can override the default endpoint by setting `engineHostName`:

:::CodeblockTabs
Code to Export account Object

```java
Account account = new Account();     
account.setDomain(""); // Domain name
account.setName(""); // Account name
account.setInstance(""); // Instance for the domain
account.setShortname(""); // Short name for the account
account.setEngineHostName("")// Optional: Override engine endpoint
```
:::

- Provide only the host name (e.g., `engine.monetate.net`) 
- Do **not** include protocol (**https\://**) 
- The SDK automatically applies https .
- If the value is null or empty, the default endpoint is used 

## 🌍 Available Endpoints

### Recommended (Default & Global)

- **engine.monetate.net**
   → Default (Akamai + nearest AWS region) 
- **engine-global.monetate.net**
   → Direct routing to nearest AWS region (bypasses Akamai) 

### 🌐 Region-Specific Endpoints (Advanced Use Cases)

- **engine-us-east-1.monetate.net **
- **engine-us-west-2.monetate.net **
- **engine-eu-west-1.monetate.net **

**Use these when:**

- Your infrastructure is hosted in a specific **AWS** region 
- You require strict control over routing or data residency 

### ⚠️ Legacy Endpoint

- `api.monetate.net `

This is a legacy endpoint and is **not recommended** for new integrations.



##  Usage Scenarios

### Default (Recommended)

If no engineHostName is configured:

:::BlockQuote
https\://engine.monetate.net
:::

###  Global Routing

:::BlockQuote
account.setEngineHostName("engine-global.monetate.net");
:::

Requests are sent to:

:::BlockQuote
https\://engine-global.monetate.net
:::

### Region-Specific Routing

:::BlockQuote
account.setEngineHostName("engine-us-west-2.monetate.net");
:::

Requests are sent to:

:::BlockQuote
https\://engine-us-west-2.monetate.net
:::

## Summary

- Default endpoint: `engine.monetate.net `
- Can be overridden via `engineHostName `
- Supports **global** and **region-specific** routing 
- SDK handles protocol and URL construction internally