Quick Start

Welcome to the Field Nation Integration Developer Portal. This documentation provides you everything you need to integrate your system with Field Nation's platform.

Prerequisites

Active Buyer Account
Integration contract in place
Sandbox credentials received
Development environment setup
Company ID documented

Don't have access to integrate yet?

Check out our website to get in touch with a member of our team. Field Nation Integrations

Quick Connect

Get your first API token and create a work order in seconds.

Authenticate

Generate an OAuth2 token to verify your access with sandbox.

curl --location 'https://api-sandbox.fndev.net/authentication/api/oauth/token' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
    "grant_type": "password",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD"
}'

Open Postman.
Create a POST request to https://api-sandbox.fndev.net/authentication/api/oauth/token.
Set Body type to JSON.
Add the payload:

{
  "grant_type": "password",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD"
}

Get Credentials

Your client_id and client_secret are provided by the implementation team during onboarding. See Prerequisites for details on credentials and Company IDs.

Create Work Order

Post a basic work order to the sandbox environment.

curl --location 'https://api-sandbox.fndev.net/workorders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
  "title": "Install Point of Sale",
  "description": { "html": "<p>Swap out the defective terminal.</p>" },
  "types_of_work": [{ "id": 62, "isPrimary": true }],
  "location": {
    "mode": "custom",
    "address1": "123 Main St",
    "city": "Minneapolis",
    "state": "MN",
    "zip": "55401",
    "country": "US"
  },
  "schedule": {
    "service_window": {
      "mode": "exact",
      "start": { "utc": "2025-06-15 09:00:00" }
    }
  },
  "pay": {
    "type": "fixed",
    "base": { "amount": 150, "units": 1 }
  }
}'