Skip to main content
Contacts represent individual people associated with an account in FieldIU. You can create contacts and link them to existing accounts.

​
Create Contact

Creates a new contact record in FieldIU.

​
Request Body

​
firstName
string
Contact’s first name
​
lastName
string
Contact’s last name
​
email
string
Contact’s email address
​
mobilePhone
string
Contact’s mobile phone number
​
businessPhone
string
Contact’s business phone number
​
accountId
string
The ID of the account this contact belongs to
​
buildingLocation
string
Building or location name
​
street1
string
Street address line 1
​
street2
string
Street address line 2
​
city
string
City
​
postalCode
string
Postal / ZIP code
​
state
string
State or province
​
country
string
Country

​
Example Request

curl -X POST https://integration.fieldiu.online/api/v1/contacts \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-ORG-ID: your_org_id" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane.smith@acme.com",
    "mobilePhone": "+1-555-000-5678",
    "accountId": "abc-123",
    "city": "Dubai",
    "country": "UAE"
  }'

const response = await fetch('https://integration.fieldiu.online/api/v1/contacts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'your_api_key',
    'X-ORG-ID': 'your_org_id'
  },
  body: JSON.stringify({
    firstName: 'Jane',
    lastName: 'Smith',
    email: 'jane.smith@acme.com',
    mobilePhone: '+1-555-000-5678',
    accountId: 'abc-123',
    city: 'Dubai',
    country: 'UAE'
  })
});

​
Response

200 OK — Contact created successfully.

​
List Contacts

Returns a paginated list of all contacts in your organization.

​
Query Parameters

​
page
integer
Page number for pagination (1-based)

​
Example Request

curl -X GET "https://integration.fieldiu.online/api/v1/contacts?page=1" \
  -H "X-API-KEY: your_api_key" \
  -H "X-ORG-ID: your_org_id"

const response = await fetch('https://integration.fieldiu.online/api/v1/contacts?page=1', {
  headers: {
    'X-API-KEY': 'your_api_key',
    'X-ORG-ID': 'your_org_id'
  }
});

​
Response

200 OK — Returns a list of contact objects.

​
Get Contact by ID

Returns a single contact record by its unique identifier.

​
Path Parameters

​
id
string
required
The unique identifier of the contact

​
Example Request

curl -X GET https://integration.fieldiu.online/api/v1/contacts/xyz-456 \
  -H "X-API-KEY: your_api_key" \
  -H "X-ORG-ID: your_org_id"

const response = await fetch('https://integration.fieldiu.online/api/v1/contacts/xyz-456', {
  headers: {
    'X-API-KEY': 'your_api_key',
    'X-ORG-ID': 'your_org_id'
  }
});

​
Response

200 OK — Returns the contact object for the given ID.