Developers

Hope you’re good. Please can you advise how I can change a phone number via the API? I have been able to change all the other fields with the below JSON example but phone doesn’t seem to work. Example JSON body:{    "name": "Dale Cooper",    "phone": 5125555555,    "custom_fields" : {        "ContactID": 12345,        "AccountNumber": "P1234",        "CustomerGrade": "CC2",        "EnhancedGrade": " ",        "BranchName": "Acme Services",        "County": "Leicestershire",        "OuterPostcode": "LE"    }} Also tried this separately within the contact object: {     "handles": [        {            "source": "phone",            "handle": "5125555555"        }    ]} Thanks

Can you please provide some examples of working list events queries using the q parameter. I am particularly interested in making use of the types filter.  https://api2.frontapp.com/events?q=<help> All my attempts at using that parameter have either returned an error or had no effect and I was unable to find any examples in the documentation.

Our team leverages Zapier for a number of automations. One of the fields that we utilize is the Assignee field. This requires that we input a User ID (for example, the teammate ID’s in the form of tea_XXX) to assign the conversation to a team member. While I am able to find this ID within Zapier, it can be rather cumbersome to search for each user individually.Question:Where can I find the User ID for each of my teammates (or myself) within Front?Thank you in advance

We are writing an app that processes message body and attachments in an inbox. As you know, an inbox can have multiple channels. When a rule files on arrival of a new message in the inbox and Front sends a notification to our webhook, we want to be able to identify which inbox this message is from and whether that inbox has a subscription with us. One way that we thought we could identify inboxes was using the Inbox Id that is in the JSON payload. To use this, we’d need the user to provide the identifier (id) of the inboxes that they want to be supported to the app. I am wondering whether the Inbox ID is accessible somewhere in the Front Admin UI we cannot find the client admin users can find them and enter them into a configuration page on the app side (we could not find them in an initial look)? If this is not the best way to identify inboxes and inbox owners, based on the message payload that Front sends, do you have any alternative suggestions?

Hi, We're using the JS Chat Widget API. I found an issue when using the `show` command. If the 'show' command is run too soon after the 'init' command, it has no effect. Delaying the 'show' command by using setTimeout seems to work around the problem. Is this a bug? There doesn't appear to be a way to tell if the chat is ready to be shown or not. Thanks for your help

Hi guys,How can I forward an email using the Front API? I don't see a method for that, although the Forward button exists in UI.Any suggestions?

Our use case is that we want to automate the process of adding a new Twilio phone number to an existing inbox. So that the agent can continue to receive sms responses from both numbers (old plus new one). Since each inbox was created manually on the Front website, we can't locate the inbox id for a specific agent.  Want to know if the Front team can support filtering on the Get channels endpoint?

We were showing front chat app icon on FE to communicate with our support team, everything was working fine from the past years, recently the icon is not showing anymore, We have initialised FCSP token and frontChat too. But we don't know how suddenly this stops working.Is there any expiry date in token?Or is there any change is script to integrate front chat?<script src="https://chat-assets.frontapp.com/v1/chat.bundle.js"></script><script> window.FCSP = 'xxx';</script> 

The way we are currently using Front is we create contacts beforehand using https://dev.frontapp.com/reference/post_contacts and then use https://dev.frontapp.com/reference/post_channels-channel-id-incoming-messages to create a conversation for them with one of our agents. This endpoint works for us because we can pass contact_id in the sender object but the problem is it does not return the conversation_id that we need for sending further messages within this conversation. Instead we are getting back the message_id only and have to query for the message entity to get the conversation_id from it. This makes our flow inefficient.  Another way to create conversation is https://dev.frontapp.com/reference/post_channels-channel-id-messages and it does return the conversation_id but it does not accept contact_id param to create conversation for existing contact. Ideally we want to be able to create conversation for existing contact_id and receive back the conversation_id in the same request.

My webhook  loading time is around 5.3 sec but it works for "inbound" message events  and you recommended loading time below 5 sec so for manual move do we have different webhook loading time and what do you recommend 

What are the differences in events payloads for “move” events between rules and manual user actions?

Can we find which inbox/mailbox/folder the user is in at any given time via the Plugin SDK?This is then used so that when the user later returns to the inbox we can return them to the last message they were on in that particular mailbox.

We are currently after a historical backload of our Front's event stream prior to 14-06-2022.I've looked at the get_events API and tried fetching events from it but:No matter how we specify the start/end timestamp parameter the API will return the event starting from the current time It only emits 15 events per fetch.Please let me know

Using the API, I would like to list all the conversations with status = "assigned" as described here:https://dev.frontapp.com/reference/list-conversations I'm not sure how the endpoint should look like. Can you please send me the endpoint with the query params? Thanks

Looking for information on OAuth. Also, does it support PKCE?

I’m looking for your rate limiting policies

We are wanting to use the API to create custom channels. The only piece we can't automate right now is creating the Channel. We have the inbox, but need a way to create the channel, and add it to the inbox so that we can get the channel ID, add our endpoint to the channel for messages, etc… Where in the API would be input endpoint for our service when messages are sent from Front?

You can now create and manage apps directly in Front with the new Developers page! The Developers page is available in your company settings (you must be an admin to view).  View and manage all your apps in one placeWhether you're creating a Core API integration, a plugin, or a new channel type, the Developers page will be your one-stop shop for managing all the integrations you are developing or have published in the past. Read the full details in the Create, manage, and publish apps topic. Obtain OAuth or API token credentials without requiring assistance from Front SupportYou no longer have to contact Front Support to obtain OAuth credentials for your apps. You can now obtain your client ID, secret, and specify redirect URLs directly in Front for new apps. Note that existing OAuth credentials will continue to work, but will not appear in the app list.The new Developers page also lets you manage API tokens, which used to live under the Plugins & API section of the settings (remov

To add a comment to a conversation, the API requires us to pass the conversation ID. But when we create the conversation using the API in the custom channel, we do not get the conversation ID in the response. The response for the above only gives us the following keys:conversation_reference message_uid statusTo pass a comment after creating the conversation, we need the conversation ID.How do we get this?Sample response data:data: {    conversation_reference: 'i:16623333570-h:62fb674ca562f438cbaeba4c06_game_62e4fc8e73e3232322668b3efbe3',    message_uid: 'fe445d0cb7b72a48460829e74fd82332fdcd',    status: 'accepted'  } 

Are these the only API end points for CSAT data? num_csat_survey_response and pct_csat_survey_satisfaction ?  What is the suggested method for customers to get all CSAT data via the API? Would it be by leveraging a full events export?  What if they also want the "raw" CSAT data? Looks like those end points will only pull total # and averages, correct?

I’d like to send more data to the custom channel endpoint, like sending more customer data, sending a tag, etc. The endpoint seems like it only receives messageshttps://dev.frontapp.com/reference/post_channels-channel-id-incoming-messages I assume I can make additional calls after the conversation exists to perform actions like adding tags, and that I can hit the Contact API endpoints to create/modify the Contact record.However, I’m hunting through the docs and I can’t find where I can get a contact_id from the message_uid that is returned when I create the message in the custom channel. I can of course create a contact before calling the custom message endpoint, but that fails if the contact exists already, which, maybe that is fine. Ideally the system can send the message, and then I can just grab the contact_id of the contact on that message, and add meta-info after the fact. I can’t even find an endpoint to grab a contact ID by handle, that’s the other strategy to avoid a 429 failu

We're working with a third party company on an integration with our data in Front, and we're hoping to get some support on pagination through the Events API.  I am trying hit the list events endpoint. I am able to make the first request successfully.In the response, I see"_pagination": { "next": "https://api.frontapp.com/events?q=after:2022-08-11T16:05:03.088883Z&page_token=XXX..." }However, when I make the request with this link, I run into the following 400 response with this message"status":400,"title":"Bad request","message":"Query parameter page_token is invalid." I was hoping you might have some insight here? 

I need a little direction with something I’m struggling with. One of my teammates previously wrote a webhook that triggered whenever an email was received. This works regardless of if the user opens the email.I’m looking for a way to limit the amount of times the function executes so instead I’m trying to build functionality that will on a button click within the plugin, select some emails starting at the newest in the current email inbox and run a function on each of them.Any chance someone can point me in the right direction?Thanks! 

Please advise where I can find the developer environment within my front connection.

Hi, We recently adopted Front for our Sales Team but the CRM we use, Copper, does not have a native integration. I was told that we could use Zapier to create connections between the two systems but unfortunately, it appears that most of the functionality exists only in shared or team inboxes.  Upon exploring further, there does seem to be an available API connection via Webhooks by Zapier. Can you help shed light on this?