Update Affiliate User Information

PUT

api

company

users

{id}

Update Affiliate User Information

curl --request PUT \
  --url https://api.fluid.app/api/company/users/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Dwight",
  "last_name": "Schrute",
  "phone": "+15705550142",
  "bio": "Assistant to the Regional Manager. Top paper salesman, Scranton branch.",
  "time_zone": "America/New_York",
  "affiliate": {
    "username": "michael-scott"
  }
}
'

import requests

url = "https://api.fluid.app/api/company/users/{id}"

payload = {
    "first_name": "Dwight",
    "last_name": "Schrute",
    "phone": "+15705550142",
    "bio": "Assistant to the Regional Manager. Top paper salesman, Scranton branch.",
    "time_zone": "America/New_York",
    "affiliate": { "username": "michael-scott" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: 'Dwight',
    last_name: 'Schrute',
    phone: '+15705550142',
    bio: 'Assistant to the Regional Manager. Top paper salesman, Scranton branch.',
    time_zone: 'America/New_York',
    affiliate: {username: 'michael-scott'}
  })
};

fetch('https://api.fluid.app/api/company/users/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/company/users/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => 'Dwight',
    'last_name' => 'Schrute',
    'phone' => '+15705550142',
    'bio' => 'Assistant to the Regional Manager. Top paper salesman, Scranton branch.',
    'time_zone' => 'America/New_York',
    'affiliate' => [
        'username' => 'michael-scott'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/company/users/{id}"

	payload := strings.NewReader("{\n  \"first_name\": \"Dwight\",\n  \"last_name\": \"Schrute\",\n  \"phone\": \"+15705550142\",\n  \"bio\": \"Assistant to the Regional Manager. Top paper salesman, Scranton branch.\",\n  \"time_zone\": \"America/New_York\",\n  \"affiliate\": {\n    \"username\": \"michael-scott\"\n  }\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.fluid.app/api/company/users/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"Dwight\",\n  \"last_name\": \"Schrute\",\n  \"phone\": \"+15705550142\",\n  \"bio\": \"Assistant to the Regional Manager. Top paper salesman, Scranton branch.\",\n  \"time_zone\": \"America/New_York\",\n  \"affiliate\": {\n    \"username\": \"michael-scott\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/company/users/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"Dwight\",\n  \"last_name\": \"Schrute\",\n  \"phone\": \"+15705550142\",\n  \"bio\": \"Assistant to the Regional Manager. Top paper salesman, Scranton branch.\",\n  \"time_zone\": \"America/New_York\",\n  \"affiliate\": {\n    \"username\": \"michael-scott\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": 48213,
  "company_id": 1405,
  "active": true,
  "external_id": "DM-REP-1042",
  "username": "dwight-schrute",
  "image_url": "https://cdn.fluid.app/dunder-mifflin/avatars/dwight-schrute.jpg",
  "mysite_url": "https://dunder-mifflin.fluid.app/dwight-schrute",
  "legacy_number": null,
  "metadata": {
    "branch": "Scranton",
    "territory": "Lackawanna County"
  },
  "roles": "rep",
  "share_guid": "dwight-schrute",
  "affiliate": {
    "id": 48102,
    "external_id": "DM-REP-1001",
    "username": "michael-scott",
    "email": "michael.scott@dundermifflin.com",
    "credit": "michael-scott"
  },
  "rank": "senior-sales-rep",
  "member_id": "0192f3a8-7c41-7d2e-9b6a-3f1e2d4c5b61",
  "user": {
    "id": 20977,
    "email": "dwight.schrute@dundermifflin.com",
    "first_name": "Dwight",
    "last_name": "Schrute",
    "avatar": null,
    "phone": "+15705550142",
    "google_id": null,
    "bio": "Assistant to the Regional Manager. Top paper salesman, Scranton branch.",
    "facebook": null,
    "instagram": null,
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/dwight-schrute",
    "whatsapp": null,
    "wechat": null,
    "youtube": null,
    "zip_code": "18505",
    "dob": "1970-01-20",
    "gender": "male",
    "time_zone": "America/New_York",
    "dnd": "off",
    "language": {
      "name": "English",
      "iso": "en"
    },
    "country": {
      "name": "United States",
      "iso": "US",
      "num_code": 840
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "code": "<string>",
    "blocked_date": "2026-11-30",
    "blocked_day": 30,
    "allowed_date": "2026-11-28",
    "scheduled_date": "2026-12-10",
    "last_bill_date": "2026-11-10",
    "requested_date": "2026-11-30",
    "payment_uuid": "<string>",
    "error_details": [
      {
        "code": "<string>",
        "field": "<string>",
        "payment": "not_attempted",
        "message": "<string>"
      }
    ],
    "coded_recovery": true
  }
}

Authorizations

Authorization

string

header

required

Bearer token authentication

Path Parameters

string

required

Unique identifier of the affiliate

Body

application/json

affiliate

Affiliate1 · object | null

Show child attributes

first_name

last_name

avatar

phone

google_id

bio

facebook

instagram

twitter

wechat

youtube

zip_code

dob

gender

time_zone

push_notifications

email_notifications

sms_notifications

Response

Success

A company member (rep or admin) with the user profile it belongs to. On a sandbox test store, a droplet or OAuth token receives no username, image_url, mysite_url, legacy_number, roles, share_guid, affiliate or user.

Member ID. Use it as {id} on the other company user endpoints.

company_id

integer | null

ID of the company the membership belongs to.

active

boolean | null

Whether the membership is active.

external_id

string | null

The member's ID in your external system.

username

string | null

Member username, used in share links.

image_url

string | null

Avatar URL.

mysite_url

string | null

URL of the member's personal site.

legacy_number

Legacy member number carried over from a previous system, if any.

metadata

object | null

Custom key-value data stored on the member.

Show child attributes

roles

string | null

Member type slug (for example rep or customer), or admin.

Share identifier (mirrors username).

affiliate

object | null

The member's sponsor. An empty object when the member has no sponsor.

Show child attributes

rank

string | null

External ID of the member's rank.

member_id

string | null

Member UUID, the same key sent in member webhooks. Null for older records that have none yet.

user

object | null

The user profile behind the membership.

Show child attributes

Update Affiliate User Information

curl --request PUT \
  --url https://api.fluid.app/api/company/users/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Dwight",
  "last_name": "Schrute",
  "phone": "+15705550142",
  "bio": "Assistant to the Regional Manager. Top paper salesman, Scranton branch.",
  "time_zone": "America/New_York",
  "affiliate": {
    "username": "michael-scott"
  }
}
'

import requests

url = "https://api.fluid.app/api/company/users/{id}"

payload = {
    "first_name": "Dwight",
    "last_name": "Schrute",
    "phone": "+15705550142",
    "bio": "Assistant to the Regional Manager. Top paper salesman, Scranton branch.",
    "time_zone": "America/New_York",
    "affiliate": { "username": "michael-scott" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: 'Dwight',
    last_name: 'Schrute',
    phone: '+15705550142',
    bio: 'Assistant to the Regional Manager. Top paper salesman, Scranton branch.',
    time_zone: 'America/New_York',
    affiliate: {username: 'michael-scott'}
  })
};

fetch('https://api.fluid.app/api/company/users/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fluid.app/api/company/users/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => 'Dwight',
    'last_name' => 'Schrute',
    'phone' => '+15705550142',
    'bio' => 'Assistant to the Regional Manager. Top paper salesman, Scranton branch.',
    'time_zone' => 'America/New_York',
    'affiliate' => [
        'username' => 'michael-scott'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fluid.app/api/company/users/{id}"

	payload := strings.NewReader("{\n  \"first_name\": \"Dwight\",\n  \"last_name\": \"Schrute\",\n  \"phone\": \"+15705550142\",\n  \"bio\": \"Assistant to the Regional Manager. Top paper salesman, Scranton branch.\",\n  \"time_zone\": \"America/New_York\",\n  \"affiliate\": {\n    \"username\": \"michael-scott\"\n  }\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.fluid.app/api/company/users/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"Dwight\",\n  \"last_name\": \"Schrute\",\n  \"phone\": \"+15705550142\",\n  \"bio\": \"Assistant to the Regional Manager. Top paper salesman, Scranton branch.\",\n  \"time_zone\": \"America/New_York\",\n  \"affiliate\": {\n    \"username\": \"michael-scott\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/company/users/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"Dwight\",\n  \"last_name\": \"Schrute\",\n  \"phone\": \"+15705550142\",\n  \"bio\": \"Assistant to the Regional Manager. Top paper salesman, Scranton branch.\",\n  \"time_zone\": \"America/New_York\",\n  \"affiliate\": {\n    \"username\": \"michael-scott\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": 48213,
  "company_id": 1405,
  "active": true,
  "external_id": "DM-REP-1042",
  "username": "dwight-schrute",
  "image_url": "https://cdn.fluid.app/dunder-mifflin/avatars/dwight-schrute.jpg",
  "mysite_url": "https://dunder-mifflin.fluid.app/dwight-schrute",
  "legacy_number": null,
  "metadata": {
    "branch": "Scranton",
    "territory": "Lackawanna County"
  },
  "roles": "rep",
  "share_guid": "dwight-schrute",
  "affiliate": {
    "id": 48102,
    "external_id": "DM-REP-1001",
    "username": "michael-scott",
    "email": "michael.scott@dundermifflin.com",
    "credit": "michael-scott"
  },
  "rank": "senior-sales-rep",
  "member_id": "0192f3a8-7c41-7d2e-9b6a-3f1e2d4c5b61",
  "user": {
    "id": 20977,
    "email": "dwight.schrute@dundermifflin.com",
    "first_name": "Dwight",
    "last_name": "Schrute",
    "avatar": null,
    "phone": "+15705550142",
    "google_id": null,
    "bio": "Assistant to the Regional Manager. Top paper salesman, Scranton branch.",
    "facebook": null,
    "instagram": null,
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/dwight-schrute",
    "whatsapp": null,
    "wechat": null,
    "youtube": null,
    "zip_code": "18505",
    "dob": "1970-01-20",
    "gender": "male",
    "time_zone": "America/New_York",
    "dnd": "off",
    "language": {
      "name": "English",
      "iso": "en"
    },
    "country": {
      "name": "United States",
      "iso": "US",
      "num_code": 840
    }
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "code": "<string>",
    "blocked_date": "2026-11-30",
    "blocked_day": 30,
    "allowed_date": "2026-11-28",
    "scheduled_date": "2026-12-10",
    "last_bill_date": "2026-11-10",
    "requested_date": "2026-11-30",
    "payment_uuid": "<string>",
    "error_details": [
      {
        "code": "<string>",
        "field": "<string>",
        "payment": "not_attempted",
        "message": "<string>"
      }
    ],
    "coded_recovery": true
  }
}

Overview

Storefront

Commerce

Checkout

Member API

Member Sites APIs

Messaging

Cowork

People

Payments

DAM

Website

Portal

Mobile app

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Unsorted endpoints

Portal & Widgets

Update Affiliate User Information

Authorizations

Path Parameters

Body

Response