Using the Mail API to update ticket properties from your inbox

Return to top
Have more questions? Submit a request


  • Andrew Bone

    Can this be done for the #cc email address?
    We get clients reporting issues, but wish to add the Sales account manager by CC

  • Anna Mae Alonzo-Casacop
    Zendesk Customer Advocate

    Hi Andrew,

    Unfortunately the #CC command is not yet available for the Mail API, only the commands above are the ones present at the moment. That does seem like an interesting feature, would it be possible if you can post in on our Product Feedback here:

  • Jennifer Morris

    Hi All, perhaps I missed it. I have been skimming through the email channel articles but I am not certain if the fw: and re: issue has been addressed. We recently implemented the email channel through our technical support group boxes. Many people use these boxes to carry on conversations about an issue between the dealers, internal as well as external customers. We end up with multiple tickets about the same issue. This seems to be due to the re: when replies are made and fw: when email s are forwarded. Outside of manually merging these conversations, is there anyway to streamline this by stripping off the re: and fw: prefix to the title of the emails when they come into our Zendesk? Clear as mud?

  • Adrian Stefan

    I'm having an issue whereby the #requester command works in the sandbox environment, but not the production one. The designated requester is a light agent user, configured the same in both environments. I have copied/pasted the source email from the production environment -- which didn't have the intended effect -- into an email I sent to the sandbox support environment, and the requester was correctly updated. Any ideas on what may have caused this behavior?

  • Tom Walker

    +1 for #appendtags - this would make the functionality actually useful. Default behavior of purging all existing tags is contrary to logic seeing tags are a major functionality linchpin for ticket workflow.

  • James Green

    This is exactly what I was looking for as our team has many shared inboxes and this lets me simultaneously respond and create a ticket when it's support-related.

    +1 for custom fields (as I have mandatory custom fields)

    +1 for #take short code for assignee (although #assignee my_email is fine)

  • Graeme Carmichael
    Community Moderator


    Here's a crazy idea. If your mail client supports auto correct, you can set up a short cut for '#assignee my_email' and other mail commands.

    In Outlook, it is under File>Options>Spelling and Auto Correct>Auto Correct Options.

    Might save you some time and some typos ;)

  • James Green


    Not a bad workaround. I just set up text expansions for the whole thing:

    for example, "#zdforp" becomes

    #assignee my_email


    I'm a fan of TextExpander, but I think there are free alternatives. OS X's native text replacer is a bit unreliable in my experience.

  • Steven Ramos

    @Kevin Hill - Add c.c.'s to the ticket using email reply by just entering the email address in the message's c.c. field. No #command in the body is necessary. I agree that it would be nice if we could also do this by #command in the API as well.

  • Chris Swinney

    I have raised a feature request via the support desk, but would like to add it here for further exposure.

    I would like to see the addition of a Mail API command that either substitutes the ticket number for something like #ticket, or to replace it with some pre-defined text (which would also include the ticket number).

    Use Case: We wish to proactively provide support, raising tickets on behalf of a customer based on an event (such as an automated crash response). As part of the first ticket, we want to provide a place where customers can upload a large file to, way beyond something that can be handled as an attachment. To this end, we offer our customers a portal, and the uploads are associated with the ticket number such that they can click on a link and go straight to the correct page. This URL takes the format of:


    At the moment, I have to raise the ticket, wait for Zendesk to reply with the ticket reference, then send a second email with the link, which is a bit rubbish.

    Of course, the replacement would need to be in the BODY of the email. So we would have something like:

    Hi User,

    Please upload to:



    You already have some ability here as of course Zendesk assigns a ticket reference and adds it to the response email. This will perhaps somehow stand on the back of that feature.



  • Bob Sherer

    I back Chris Sweeney's request and will go hunt that down and say so there.

    We would use it when creating an RMA ticket for a customer based on a phone call and not a technical support ticket. We use the ticket number as the RMA number and currently have to figure out what the next ticket number will be (and race to claim it) or do things in two steps. Being able to indicate in the body of the email that I want you to stick the new ticket number there would help a lot.

  • Chris Swinney

    I should also say this request above would be useful in follow up emails, not just initial email. Again, we point our customers to a URL based on the ticket number, The only way I have to do this today it to paste preformatted text, but keep manually updating the URL, which has inevitably led to human error in the past.

  • Chris Swinney

    Further to the above (WRT adding URLs/Text containing the ticket number), you guys already have the idea of Marcos. We have a simple Marco that inserts, something like:

    Please upload the file to{{}}

    The problem with this is it doesn't work on NEW tickets (ones that we raise on behalf of our customers).

    So, firstly this field needs to be able to be processed during the ticket creation submission stage, rather than text entry stage, AND we need a way to reference that Macro via the Mail API.

  • Chris Swinney

    Is there any progress on the #cc command?

    this was raised as the very first comment in this post back in June 2012, over 4 years ago! It has been repeated multiple times since. A quick search found suggestions posted in the Product Feedback forum over 7 years ago!!!!

    Perhaps this is something that needs to be implemented......

  • Michael Carrabine

    +1 on the #cc command

  • Zvika Dror

    How do I unsubscribe from this thread? Important feature requests or features gets no response from ZenDesk, so what's the point?

  • Helvijs Vigners

    We have automated systems that send out notifications to zendesk with requests that need to be actioned.


    We were wondering if there will be an improvement to add #requester when non agent sends that?


    This would be useful!

  • Juliet

    I've been toying around with the Mail API for adding internal notes. We often "escalate" tickets to the Sales group who works strictly from email. By default, I have all replies from email set to PRIVATE (as Sales usually starts off with internal chatter about how to prioritize the lead). 

    I was hoping they could use #internal to chatter amongst themselves and #public when they are ready for the requestor (end user) to see it. However, when the first #public reply is sent, all of the previous internal chatter is added to the body of the email (this was meant to be for our team's eyes only i.e. internal notes). 

    Any ideas for how to make this work? I'd love for Sales to be able to talk amongst themselves before replying, but it makes this feature pretty useless if sending a public reply makes all previous internal notes visible to the customer. Any suggestions?

    I'm also open to an entirely different workflow but the idea is that Sales likes to chat amongst themselves and they like to work from email (not the Zendesk dashboard). 

    See test ticket below. As soon as the public reply was sent, it added the private note to the body (visible to end user): 


    This is a screenshot of the email (what it looks like to the end user). They can see the private note!  "Let's call him ASAP!" 

  • James Green


    Maybe the issue is in your "Notify requester of comment update" trigger?

    I use this in the Email body:

    {% for comment in ticket.comments limit:1 offset:0 %}
    {% for attachment in comment.attachments %}
    {% endfor %}
    {% endfor %}

    Note the limit:1

    This makes sure only the most recent comment is sent (in this case your public reply). I do this to make everything seem as email-like as possible, rather than helpdesk-like

  • Max McCal
    Zendesk Product Manager

    Juliet - 

    This is clearly an issue, but I'm not sure what's causing it. I'm submitting your comment to our Support team to investigate it privately.

  • Mindaugas Verkys

    Maybe would be possible to update custom ticket fields?

  • Jean-Francois Boudreault

    Could #requester uses the external ID ?

  • Bradley Ladwig
    Zendesk Team Member

    Hi Jean-Francois!  It would not be possible to use external ID for #requester.  You can use an email address or user ID of an exiting user.

  • Chris Swinney

    Hi Zen Support,

    We have been trying to figure out a way to best serve our customer through pro-active support tickets, and there are some things thet Zen simply doesn't support, but comes close in other areas.

    The workflow is something like this

    1. ACR from the customer software is reported to our ACR server, and generate an internal issue for tracking
    2. We then raise ticket on behalf of the customer using the Email API, inserting relevant information commands such as:

      #group Incident reports
      #requester ****@****
      Some info about the ACR

    3. An automated trigger has been setup to forward a properly formatted email to the customer indicating where to upload more information such as below. This has to come now as we have no idea what the ticket number will be before we create the ticket, and the upload URL uses the ticket number to cross link the information.{{}}

    4. In this way, the customer does NOT get the first email when we raise the ticket on their behalf, but receive a nicely formatted auto response. The problem is that as we reply, they see the first entry, which is not what we are after.
    5. Lastly we cross link the ticket and ACR issue. 

    As such, I though it would be a simple task of adding the #note property to the first email from us, thus:

    #group Incident reports
    #requester ****@****
    Some info about the ACR
    Private link to GIT repository....

    By doing this, it means we "should" be able to add additional private commentary in the first email, the customer get the auto-response, but the ticket then carries on. Problem is, this doesn't work. The initial email remains public.

    The alternative method is for Zendesk to support Mail API commends in the initial email that could then be substituted when processed and turned into a ticket (also mentioned in my post a while ago above), however this seem more ticket.

    The addition of the #note in the first email would seem to be a simple win here.



  • Jessie Schutz
    Zendesk Team Member

    Hey Chris!

    I think I understand what you're getting at here, but please let me know if I'm off the mark. What I'm reading is that you don't want your end-user to see the very first comment on the ticket that you've created on their behalf.

    The good news is that we just went live with a functionality that allows you to create a ticket with the very first comment as an internal note. You might need to tweak your workflow a little bit to make sure that notifications are sent out to your requesters properly, but I think this will solve your problem.

    You can find more information about that here: 

    Let me know if I misunderstood anything!

  • Karyn Tooke

    Similar to Tom Walker i'd like to see the command #addtag as many of our internal customers (without a zen account) use emails to chase for updates. Strange to think the command #tags would remove previously set tags.

  • Renee

    Would this work using the Outlook integration tool? My agents say that the tool does not auto assign when creating a ticket from Outlook.

  • Chris Swinney

    @Renee -there is an Outlook integration tool? I (an others) had asked for something like this years ago, but I didn't realise one existed.

  • Chris Swinney

    Awesome, that one passed me by.


Please sign in to leave a comment.

Powered by Zendesk