Developer Q&A

How can I link a message or conversation to another conversation, just like I can do it from the UI using the "Link to original" button?  I know how I can link conversations, but it's not the same as when it's done via the UI. I need to do this via the API, and there simply doesn't seem to be any option to do this. When I look through the API docs and I link the conversation, then it is just added on top as an external link, but I wanted to be internally linked within the conversation around the original conversation, just like I do it from the UI.  How would I use the API to do this? 

So to start a new whatsapp conversation (to say, e.g., alert one of our customers about a status to their property which we service) we must send out an approved template. The front api for creating a message has no such template_id field. This should be okay, because you can `https://api2.frontapp.com/message_templates/{message_template_id}` to get the message template and then just use the body. except(1) this won’t fill in the tag fields automatically from the contact; and [more importantly](2) whatsapp rejects this message because it isn’t an approved template it seems if we use the same body it isn’t necessarily the same template. How can one use the api to send a template message to start a new whatsapp conversation?

 Good morning,I’m trying to sync the Front conversation statuses in Front with our internal data so we can display them to our users in our app. We just need to get the Open/Waiting/Resolved value from the conversations. I'm playing with the application webhooks, as recommended in your docs, but I cannot find an event that reacts to a change in these statuses (there are some internal status changed events but for Waiting and Resolved are, internally, the same “archived” status so nothing triggers in this case). I’ve gone around this issue by creating a custom rule that adds a tag when the status changes so I can receive the “Tag added” event but then I’m getting a lot of events that are not actually changing the status… The other solution will be polling directly the API but given the API request per minute restriction, if the inflow of tickets grows it might not be realistic. Is there anything else we can do, or something that we are missing? Thanks in advance,Ruben

Hello we’ve just started using front and we don’t have the time to figure out what we don’t know what we don’t know. Is there a partner directory or anyone who’s doing consulting paid consulting?We’re an IT business and have no issues spending cash on software implementation but Front doesn’t seem to be offering this service. Please help it’s a fantastic tool I’m sure but oh boy it takes a while to figure things out!

Hello,For one of our mutual customer we are seeing that conversation events are missing from /events api call.While individual event exist when queried via /conversation/[id]/events endpoints.I have also checked it’s not a private resource. Also checked the api token access it’s all correct.I can share more details if we can start a thread around api call and conversation which is missincg, since it’s one of our mutual customers data I am not posting here our public forum.Let me know how to debug this.I have already created a support ticket.

Setup: I sync messages from the Core API and process them downstream. For that I need just the new content of each message, not the quoted thread history, signatures or disclaimers.What the API gives me:- `body` - full HTML, including everything- `text` - plaintext rendering, also including everything- `blurb` - quote-free, but truncated, so usable as a signal at bestSo I'm parsing the HTML myself, and running into the usual wall: no standard for marking quoted content, every client does it differently, unclosed tags, tables used for layout. Forwards are the worst case, some clients wrap the entire forwarded message in a single blockquote, so naive stripping leaves an empty body.Front clearly handles this internally (collapsed quotes in the UI, the `front-quoted` class, rules that skip quoted text when matching conditions).1. Is that exposed anywhere I've overlooked, an endpoint, field, parameter, or a paid add-on? Happy to pay for it.2. If not, what are you all using? Interested in wh

Hi all,We're an AI agent provider integrating with our customers' Front instances. Our integration has two parts: (1) webhooks so we receive conversation events from each customer's instance, and (2) an embedded React app (plugin/iframe) that loads contextually in the Front sidebar.Today, onboarding each customer is manual: we ask each tenant to create/initialize a webhook app in their own instance, exchange credentials with us, and configure everything by hand. This is slow, error-prone, and doesn't scale.What we'd like instead:Ship our integration as a single installable Front application (ideally via the App Store or as a private/partner app). Customers install it and complete a short setup form; our backend receives the install, and we can approve or reject the tenant on our side. Webhook subscriptions and credential exchange are auto-configured per tenant on install (OAuth flow), rather than each customer manually creating webhook apps. The plugin (React iframe) ships as part of t

Hi Front team,We use the Front Chat widget with our knowledge base enabled inside it, and we'd like to extend the widget's in-app Help Center experience to article links that live elsewhere in our web app.Context on what we're doing:We've started adding contextual tooltips throughout our web app that link to the relevant Front KB article for each feature. This has been great for helping users understand features — especially newer ones — right at the point where they encounter them.The one bit of friction: those tooltip links open the article in a new browser tab, pulling the user out of our app. What we love about the widget's built-in Help Center is that when an article is linked inside the widget (from a chat reply, or from a link within another article), clicking it just opens the article in the Help Center tab of the widget. The user can read the full article, expand the widget for a better view, and follow along while staying in our app. That in-context experience is exactly what

I love the new knowledge base integration with AI, but I’d like to add additional context to the AI based on the user submitted message the AI is looking at.Having the AI have access to our MCP server means it can look up specific information about the user requesting help as well as access documentation.Is that a possibility?  I couldn’t find a good approach using Connectors.

Hi,                                                                                                               Trying to figure out how to create and manage Sequences via API and coming up empty. The public Core API spec has no sequences paths, the dev portal reference doesn't mention them, and there's nothing in the changelog.A bit disappointed we are not being able to drive them programmatically. This means we either keep humans clicking through the UI or rebuild a sequencing engine on top of public primitives. Both of which are worse than a thin API wrapper would be.A few questions:Are sequence endpoints available on any plan tier or beta that's just not in the public spec? Is there a roadmap item or feature request to track / +1? If sequences endpoints aren't coming, what's the recommended composition for sequence-like workflows in their absence?

We have a use case where we have a unique id, e.g. 12345, for each customer case and we want to have a unique email address with that id, e.g. 12345@cases.example.com, that a customer can send emails to when they have queries. We have setup the inbound flow so customers can send us emails to the unique email address and we can see them in the Front inbox, however, we can’t seem to be able to specify we are replying from that unique email address or set the reply to header to be that unique email address. This breaks our workflow. Is there any way around this?

Hi all, I’m struggling with something….I have a conversation custom field “Shipment Number” and an app object which is basically just a URL.I want to append the shipment number to the URL. Then I can create rules to populate this object when Shipment number is filled in.Is this possible?

Hi friends!I am implementing a custom solution and need to be able to search and identify contacts on Front with their phone number.I have tried https://api2.frontapp.com/contacts/alt:phone:[Number] returns an exact result if the number exists. However in many cases the number doesn’t exist and it return a 404 error which causes the custom template I am building to crash.I have also tried https://api2.frontapp.com/contacts?q=[Number] but the problem is that the query is ignored and all the contacts we have are returned every time and these contacts have no connection to the query. This is really not helpful. If this endpoint can return only contacts that have the query as a handle or name, that will be a lot more helpful.Has anyone had a reason to do something similar or is there anything I must have missed with searching contacts with the query method?

I’ve made a private oauth app to access resources. Only shared resources. I’ve limited the resource permissions to a pretty vanilla degree. However, whenever someone in my company tries to authorize the app, if they are not an admin then they cannot proceed.Is this expected, or am I doing it wrong? 

I am currently using the Front sdk updateDraft function in the updateMode: ‘replace’ when I run it with only the subject defined, all attachments on the draft get deleted.  await sdk.updateDraft(draftId as Parameters<FrontSdk['updateDraft']>[0], { updateMode: 'replace', subject: subject });This is the current code I am using.

Hello, I need a way to add custom headers into a rule webhook call, in order to call internal routes that need API keys.The solution we found was to provide the API key directly into the path parameters, but that makes it so the key leak internally in our logs. Also, making the route key-less is not an option for us.

Hi everyone, nice to meet you!I have two questions regarding analytics reports:1 Metrics showing 0:When I request a report with:metric_names = ["num_messages_sent", "num_messages_received"]start_dt = datetime(2025, 8, 10, 0, 0, 0)end_dt = datetime(2026, 3, 1, 0, 0, 0)account_id = [account_id]I get:'metrics': [ {'id': 'num_messages_sent', 'type': 'number', 'value': 0}, {'id': 'num_messages_received', 'type': 'number', 'value': 0}]However, when I manually check the contacts and conversations for this account, there are messages sent in that interval. I don’t understand why the report shows 0. Here is my code if it helps:metric_names = ["num_messages_sent", "num_messages_received"]start_dt = datetime(2025, 8, 10, 0, 0, 0)end_dt = datetime(2026, 3, 1, 0, 0, 0)account_ids=['acc_xxxxx']start_ts = int(start_dt.timestamp())end_ts = int(end_dt.timestamp())body = { "start": int(start_ts), "end": int(end_ts), "timezone": "UTC", "filters": { "account_ids":

I am working on a project that requires I pull data from our in house database and run reports from those and send them automatically to the respective managers that requires the report. We run these reports weekly. I would like to use Parabola to run the emails through Front. Is this something anyone has had experience with and have any thoughts on how this worked or didn’t work for you?

Hi Front team 👋We have a plugin which is created using @frontapp/ui-kit, and we’ve run into a limitation regarding dark theme support.At the moment, most (if not all) component colors in the UI Kit appear to be hardcoded. Because of this, there’s no straightforward way to support a dark theme in our plugin without overriding the existing component styles.While overriding styles is technically possible, it doesn’t feel like a clean or sustainable solution, especially considering future updates to the UI Kit.We’d like to ask: Are there any plans to introduce official dark theme support in @frontapp/ui-kit? Is there (or will there be) a theming system using design tokens, CSS variables, or similar approaches? What is the recommended best practice for supporting dark mode in Front plugins today?

Hi everyoneWe’re exploring ways to integrate our cloud contact center solution with Front and wanted to see what others here have done. Specifically, we're hoping to streamline agent workflows by syncing conversations, contact data, and possibly call recordings into Front.Has anyone here integrated Front with platforms like:Genesys Cloud WebEx Contact Center Talkdesk Five9

We are really struggling with this.Our goal is to receive a list of ‘open’ conversations in our personal inbox. This includes direct messages AND a any conversation that we are subscribed to (participant of) both in Shared Inboxes and Teammates Inboxes.However there’s an inherent problem: is:open is not useful whatsoever… Because status: “archived” is global, when a user outside of our personal inbox ‘archive in my inbox’ that status is now status:archived…This means I have to search for status:archived to see basically all my conversations (thousands) and find a way to figure out which ones are actually open in my view… we’ve tried /conversations/{id}/followers to see if i’m attached to that conversation, looking at conversation events… but its just not easy. If we had open graph or something maybe that would help…Does anyone know how to deal with this ‘global’ archiving issue, I should be able to see what my Front UI shows..

We have API integration with FrontApp for many years using our live account. We need to build an application channel for internal use only that will be used to handle specific type of group messages not currently supported by FrontApp.I already setup the developer app and application feature is installed. The app is verified and the webhook is working when I create messages on FrontApp directly.I am trying to sync an external message back into the channel, but I am getting this error“Only partners can access channels. Please see https://dev.frontapp.com/docs/channels-overview for access.”I looked at the documentations and it requires the app to be developed before I can get a partner account, but I can’t develop the app if I can’t sync the messages.Again, this is for internal use only. The reason we are choosing application app instead of custom channels is custom channels can’t "Compose new outbound messages with replies threaded in the same conversation"

Hi allI’m looking to save emails (and attachments) from conversations in Front to my software using its API. I’ve created application requests and can send and receive data with them. I can create a new document in my software using a Front macro but the document is empty, because I don’t know what I should use in Front to save the email and attachments too.Hoping for some pointers!Thanks

We are experiencing issues with long automated messages failing to send.There are carriers that take the long messages and carriers that don’t - we want to just retry the ones that fail. I get that I can circumvent this problem by splitting the long message into multiple small messages and send them separately. But since most of the times the messages are delivered, we don’t want to have to split successful messages because of a few unsuccessful ones.After the message is sent, I am using this endpoint to fetch the message again:"https://api2.frontapp.com/messages/{message_id}”What I want is to see if it errored or not. The issue is that I am getting the field ‘Error Type’ empty even for failed messages.Anyone has any advice here? How can I get from the API the error status of a message?