Field NationDeveloper Platform
Field NationDeveloper Platform
Quick StartPrerequisitesPlatform Overview

Prerequisites

Everything you need before building your Field Nation integration


Checklist

Ensure you have the following before starting development:

  1. Buyer Account: Application access to post and manage work.
  2. Integration Contract: Authorization to use the API.
  3. Sandbox Credentials: client_id and client_secret for authentication.
  4. Company ID: Your unique identifier for API requests.

1. Access & Contract

You must have an executed Integration Contract and an active Buyer Account.

Don't have an account or contract? Contact Sales or your Account Manager.

2. API Credentials

To get your client_id and client_secret:

Log in to your Field Nation account.

Navigate to Integration → Field Services from the top navigation.

Click Manage on the REST API v3 card.

Copy the Client ID & Client Secret. You can generate a new secret by clicking the "Generate new secret" button.

API Secrets

Important

Store your client_id and client_secret securely. Do not commit them to version control.

3. Company ID

You will need your Field Nation Company ID for API requests (x-fn-company-id header) and support cases.

Log in to the Field Nation Platform.

Click your user icon (top right) → Company Settings.

Click Company Profile. Your ID is the number at the end of the URL.

Company Profile


Technical Requirements

Network

Outbound Access (HTTPS / 443):

  • Sandbox: https://api-sandbox.fndev.net
  • Production: https://api.fieldnation.com

IP Whitelisting is not required for outbound calls.

Inbound Access (Allowlist): Ensure your firewall allows Field Nation's IPs:

Sandbox:

44.225.211.232
44.237.253.26

Production:

3.226.5.230
34.198.172.230

Tools

  • Authentication: OAuth 2.0 (Client Credentials Grant).
  • Payloads: JSON (up to 5MB).
  • Security: HTTPS required for all endpoints.

Ready?

Once you have your credentials and Company ID, go to the Quick Start to connect.

Last updated on

Quick Start

Connect your systems to the world's most active field service marketplace.

Platform Overview

minimal guide to Field Nation's architecture, lifecycle, and core concepts

On this page

Checklist
1. Access & Contract
2. API Credentials
3. Company ID
Technical Requirements
Network
Tools
Ready?