Technical FAQ

Central, living knowledge base for developers integrating social.plus. Use the quick navigation, browser find (⌘/Ctrl + F), or your docs site search to jump to relevant answers. Each category groups focused, implementation‑level questions gathered from support & community discussions.

API

Authentication • Pagination • Bulk Ops • Moderation

Social & Chat

Feeds • Communities • Roles • Media

SDKs

Platforms • Push • Blocking • Feature Gaps

Poll

Creation • Limits • Retrieval

Console

Admin • Certificates • Access • Limits

Portal

Environments • Plans • Org Data

Alt Solutions

Workarounds & Patterns

Beta Features

Realtime • Search • Webhooks

Errors

Common Failures & Fixes

General

Accounts • Theming • Multi‑tenant

Dashboard

Metrics • Definitions

Using This FAQ

Scan Categories

Skim the Quick Navigation cards to locate a domain (e.g. Errors vs API).

Deep Link

Copy the URL after clicking a section heading to share precise context with teammates.

Validate Versions

For SDK questions, confirm your SDK / UIKit versions vs latest changelogs before implementing a workaround.

Escalate Gaps

If an answer points to a workaround, log a feature request in the Developer Forum with context (scale, impact, timeline).

Contribute Back

Found a nuance or edge case? Propose an edit so the knowledge stays current.

Looking for a question that is not here? Use the Developer Forum anchor in the SDK navigation to open community discussions or submit a new thread.

API

Create users in bulk

Admin Authorization token

Pagination (next page token)

API list endpoints return a paging.next token. Pass it back as the options[token] (or documented query param) to fetch the next slice.

Example response:

{
  "paging": { "next": "eyJza2lwIjoyMCwibGltaXQiOjEwfQ==" }
}

Example request:

curl —location —globoff ‘https://api.sg.amity.co/api/v3/communities?filter=all&sortBy=lastCreated&options[token]=eyJza2lwIjoxMCwibGltaXQiOjEwfQ%3D%3D’ \
—header ‘accept: application/json’ \
—header ‘Authorization: Bearer xxx’

Bulk upload blocklisted words

Use the blocklist records endpoint:

curl --location 'https://api.sg.amity.co/api/v3/blacklist/records' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer xxx' \
  --data '{
    "regexs": ["word1", "word2", "word3"],
    "isMatchExactWord": true
}'

Set isMatchExactWord to true for exact term blocking or false for substring / regex style matches. API Ref: Moderation » Blocklists.

Configure follow / unfollow mode

Update social network settings via: PUT /network-settings/social

curl --location --request PUT 'https://api.sg.amity.co/api/v3/network-settings/social' \
  --header 'accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer xxx' \
  --data '{"isFollowWithRequestEnabled": false}'

Request higher-quality images

refreshToken vs accessToken

Authentication token lifetime

List communities I've joined (API)

Filter with filter=member on communities endpoint:

curl --location 'https://apix.sg.amity.co/api/v3/communities?filter=member&sortBy=lastCreated&options[limit]=100' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer xxx'

Renew expired authentication token

Get new auth token:

curl --location 'https://api.sg.amity.co/api/v3/authentication/token?userId=Amity' \
  --header 'accept: application/json' \
  --header 'x-server-key: xxx'

Exchange via Session API:

curl --location 'https://apix.sg.amity.co/api/v4/sessions' \
  --header 'accept: application/json' \
  --header 'x-api-key: xxx' \
  --header 'Content-Type: application/json' \
  --data '{"userId":"Amity","deviceId":"test","authToken":"xxx"}'

Obtain an authentication token (secure mode)

Find posts I reacted to

Update only user metadata

Send only the metadata field in a user update body; unspecified fields remain unchanged.

curl --location --request PUT 'https://api.eu.amity.co/api/v2/users' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer xxx' \
  --data '{"userId":"Test","metadata":{"tier":"gold"}}'

Delete ALL posts (bulk)

Upload audio files

List users by role in a community

curl --location --globoff 'https://apix.sg.amity.co/api/v3/communities/COMMUNITY_ID/users?memberships[]=member&roles[]=moderator&options[limit]=10' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer xxx'

Upload from URL?

Access token invalidated early

targetType & targetId purpose

Sort community posts by engagement?

Exclude deleted communities

API: add isDeleted=false param.

curl --location 'https://api.sg.amity.co/api/v3/communities?filter=all&isDeleted=false' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer xxx'

SDK: set includeDeleted (or includeDelete) flag false. Docs: https://docs.amity.co/amity-sdk/social/communities/query-communities

Check which communities a user joined

Only the current authenticated user can list their joined communities (filter=member). Privacy prevents enumerating others’ memberships.

curl --location 'https://api.sg.amity.co/api/v3/communities?filter=member' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer xxx'

Why only 20 items returned?

Update community user role

API (Add roles):

curl --location 'https://api.sg.amity.co/api/v4/communities/COMMUNITY_ID/users/roles' \
  --header 'accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer xxx' \
  --data '{"roles":["community-moderator"],"userIds":["test"]}'

Console path: Community > Members > (⋮) beside user > Change user role.

Remove community members

Delete / close a community

Pre-populate global feed for new users

Metadata purpose

Empty global feed explanation

Image upload requirements

Video upload requirements

Do I need access token when using SDK secure mode?

Global feed not sorted by newest

List joined communities via SDK

Implement file download feature

Auto-open first chat channel in Web UIKit

Check if conversation channel exists between users

Query posts by tags[]

Append repeated tags[]= query params.

curl --location --globoff 'https://api.sg.amity.co/api/v4/posts?targetId=COMMUNITY_ID&targetType=community&sortBy=lastCreated&tags[]=tag1&tags[]=tag2' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer xxx'

Query comments by user ID?

SDKs

iOS push not working (checklist)

Use my own Realm (iOS)?

Which iOS certificate type for push?

TypeScript via CDN only?

Check if I blocked a user

Mark message as read

Flutter: retrieve poll posts

Poll

List voters for a poll answer

Poll plus other attachment?

View my polls in console?

Console

Find admin token

Grant console access

Upload first PNS certificate

Can't retrieve community posts via User option

Locate API key & region

Change console password

Why no conversation channels in console?

Multiple push certs per platform?

Portal

Create separate environments (test/prod)

Upgrade pricing plan

Change organization name for invoices

Alternative solutions for unsupported features

Save favourite posts

Verified badge implementation

Post sharing pattern

Email notification on flagged post

Pin a post workaround (pre UIKit support)

Restrict channel creation to admins

Filter only video posts in global feed

Audio message duration shows 00:00

Retrieve community posts by userId

Beta features

Web React push notifications

Content search returns fewer posts

Search posts by hashtags

Notify user on new follower

Frequent error types: Definition

Error: Connect client first

Query Token is invalid

Unable to use SDK while logging in

RateLimit Exceed / 400311

Image post error 400314

Link post blocked 400309

General

Restore deleted user?

Delete inactive users

Global ban effects

Counting concurrent connections (CCU)

Dark theme availability

Delete unused application

Definition: inactive user

Download Figma files

Multi-tenant architecture

External backend for file uploads?

Account-wide metrics across apps

Include HTML formatting tags in posts/messages

GIF support

Dashboard

Lurking users definition

Conversation metrics location

Powered by

Getting Started

Fundamentals

Social

Chat

Video

Support

Quick Navigation

API

Social & Chat

SDKs

Poll

Console

Portal

Alt Solutions

Beta Features

Errors

General

Dashboard

Using This FAQ

API

SDKs

Poll

Console

Portal

Alternative solutions for unsupported features

Beta features

Frequent error types: Definition

General

Dashboard

Powered by

Getting Started

Fundamentals

Social

Chat

Video

Support

​Quick Navigation

API

Social & Chat

SDKs

Poll

Console

Portal

Alt Solutions

Beta Features

Errors

General

Dashboard

​Using This FAQ

​API

​Social and Chat

​SDKs

​Poll

​Console

​Portal

​Alternative solutions for unsupported features

​Beta features

​Frequent error types: Definition

​General

​Dashboard

Quick Navigation

Using This FAQ

API

Social and Chat

SDKs

Poll

Console

Portal

Alternative solutions for unsupported features

Beta features

Frequent error types: Definition

General

Dashboard