Users

POST /v1/tools/podio/getContacts

Get contact details for one or more users by their profile IDs. Returns name, email, phone, organization, and other profile fields. Supports batch lookups — pass multiple profile IDs to fetch several contacts at once. Optionally scope to a space to include role and removable properties.

Parameters

Name	Type	Required	Description
profile_ids	array	required	One or more profile IDs to look up
space_id	number	optional	Optional space ID to include space-specific role and removable properties

curl -X POST https://api.syncello.io/v1/tools/podio/getContacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "profile_ids": "..."
}'

{
  "profile_id": 4455667,
  "user_id": 1122334,
  "type": "user",
  "name": "Jane Doe",
  "mail": [
    "jane@example.com"
  ],
  "org_id": null,
  "space_id": null,
  "last_seen_on": "2026-07-01 09:15:00",
  "link": "https://podio.com/users/1122334",
  "rights": [
    "view"
  ]
}

POST /v1/tools/podio/getUserContact

Get the full contact profile for a Podio user by their user ID. Returns name, email, phone, organization, location, skills, and other profile fields. Use this when you have a user_id and need their contact details. For the authenticated user, use getUserStatus instead.

Parameters

Name	Type	Required	Description
user_id	number	required	The Podio user ID to look up

curl -X POST https://api.syncello.io/v1/tools/podio/getUserContact \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "user_id": "123"
}'

{
  "profile_id": 4455667,
  "user_id": 1122334,
  "type": "user",
  "name": "Jane Doe",
  "mail": [
    "jane@example.com"
  ],
  "org_id": null,
  "space_id": null,
  "last_seen_on": "2026-07-01 09:15:00",
  "link": "https://podio.com/users/1122334",
  "rights": [
    "update",
    "view",
    "delete"
  ],
  "location": [
    "Austin, Texas, United States"
  ],
  "title": [
    "Operations Lead"
  ]
}

POST /v1/tools/podio/getUserStatus

Get the authenticated user data, profile, and notification counts. Returns both user_id and profile_id. IMPORTANT: For contact fields in createItem/updateItem, you MUST use the profile_id from the profile object, NOT the user_id. user_id ≠ profile_id — using user_id in a contact field causes a misleading 404 error.

curl -X POST https://api.syncello.io/v1/tools/podio/getUserStatus \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "user": {
    "user_id": 1122334,
    "mail": "jane@example.com",
    "status": "active",
    "locale": "en_US",
    "timezone": "America/Chicago",
    "activated_on": "2024-01-10 08:00:00",
    "created_on": "2024-01-10 08:00:00"
  },
  "profile": {
    "profile_id": 4455667,
    "name": "Jane Doe"
  },
  "inbox_new": 1,
  "message_unread_count": 0,
  "betas": [
    "new_ui",
    "calculation_with_nulls",
    "phone_field"
  ]
}

POST /v1/tools/podio/searchContacts

Search for Podio user contacts by email, name, or other fields. Returns matching user profiles with name, email, location, skills, and other details. Use the mail parameter to find a user by their exact email address. Optionally scope to an organization or space.

Parameters

Name	Type	Required	Description
mail	string	optional	Filter by email address
name	string	optional	Filter by name (partial match)
org_id	number	optional	Limit results to members of this organization
space_id	number	optional	Limit results to members of this workspace
external_id	string	optional	Filter by external ID
order	string	optional	Sort order. "overall" sorts by relevance/activity, "name" alphabetically. Values: overall, name
limit	number	optional	Max results (default 20)
offset	number	optional	Pagination offset
required	string	optional	Comma-separated list of required fields (e.g. "mail,name")
exclude_self	boolean	optional	Exclude the authenticated user from results

curl -X POST https://api.syncello.io/v1/tools/podio/searchContacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

[
  {
    "profile_id": 4455667,
    "user_id": 1122334,
    "type": "user",
    "name": "Jane Doe",
    "mail": [
      "jane@example.com"
    ],
    "rights": [
      "view"
    ],
    "last_seen_on": "2026-07-01 09:15:00",
    "link": "https://podio.com/users/1122334"
  }
]