Skip to content
One platform. From customer conversation to completed work.Take a closer look
All connections
Communication ยท CONNECTION

iMessage by Photon + NodeHub

Manage a Photon project's iMessage lines, users, platforms and WhatsApp templates; its trigger receives inbound messages.

Explore 24 workflow actions for iMessage by Photon, including account permissions and operation limits.

13 read actions11 write actions
WORKFLOW ACTIONS

What you can configure.

Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.

Check shared number availability

Read

Checks whether a new shared iMessage number can be assigned to the given phone number under this project.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Create user

Write

Creates a new user for the project.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Create WhatsApp template

Write

Creates a message template under the given WhatsApp Business account.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete user

Write

Soft-deletes a user.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Delete WhatsApp template

Write

Deletes a single language version of a message template.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Edit WhatsApp template

Write

Edits an existing message template.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Get iMessage info

Read

Returns the iMessage service type (shared or dedicated) for the project.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Get line profile

Read

Returns the stored name and avatar for this dedicated iMessage line.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Get platforms

Read

Returns the project's platform configuration, including disabled entries (metadata is preserved across toggles).

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Get profile sync status

Read

Returns current aggregate Line convergence with no sync instance ID or history.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Get project

Read

Returns the project's display name plus, when set, its profile (firstName, lastName, avatarUrl).

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Get project profile

Read

Returns the Project Profile through the Project Basic Auth boundary.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Get user

Read

Returns a single user by ID.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

List lines

Read

Returns only dedicated phone lines the project owns across all platforms.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

List users

Read

Returns active users for the project.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

List WhatsApp Business accounts

Read

Lists the project's onboarded WhatsApp Business accounts (WABAs), newest first.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

List WhatsApp templates

Read

Lists message templates for the given WhatsApp Business account.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Remove dedicated line

Write

Deallocates a dedicated line by id.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Route to a line

Read

Returns the single best dedicated iMessage line to assign a new user to, load-balancing by active user count and recent growth.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

Sync profile to lines

Write

Idempotently aligns every active dedicated iMessage Line Profile to the Project Profile and returns after the database transaction commits.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Turn a platform on or off

Write

Enables or disables a platform for the project.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update line name

Write

Merges firstName and/or lastName into this line's stored Profile while preserving its other name and avatar.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update project profile

Write

Updates the supplied Project name fields and conditionally propagates the complete Profile to Lines that still match the old Project Profile.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

Update project slug

Write

Replaces the project's slug with the supplied value.

Permissions and limits

Account permissions

  • A Photon project ID and project secret

A repeated request may repeat the external action. Review the previous result before retrying a write.

SETUP

Start with a controlled test.

01Connect the intended account

Use the account and permissions required for your process. Review the connection check before configuring a workflow action.

02Review inputs and access

Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.

03Confirm the result

Inspect step outputs and confirm the result in iMessage by Photon. A saved workflow is not a completed provider action.

Follow the workflow quickstart
EXPLORE YOUR STACK

More in Communication.

AgentMailBolnaBotBeeBotPenguin
iMessage by Photon integration | NodeHub