Give tacos with the Taco Giving API

Our API allows you to build applications that interact with HeyTaco!. With the Taco Giving API, you can give up to 200 tacos per day. You can use this API to programmatically give tacos for birthdays, anniversaries, etc. Here's how to get started: 

Step 1. Create an app

To use the Taco Giving API you'll need to first create an app. Create New App

Step 2. Grab your HeyTaco! Secret Token

Step 2. Send POST request to the API endpoint

To use the Taco Giving API you'll send a POST request to https://www.heytaco.chat/api/app.giveTaco


Node Example

request.post({
  json: true,
  url: 'https://www.heytaco.chat/api/app.giveTaco',
  data: {
    "token": "{%SECRET_HEYTACO_TOKEN%}",
    "uid": "{%USER_ID%}",
    "amount": "{%TACO_AMOUNT%}",
    "message": "{%MESSAGE%}"
  },
},
function(error, res, body) {
  if (error) {
      console.log(error);
  }
});


Errors

response meaning
invalid_uid User ID does not exist
no_user_association User ID is not associated with team
invalid_taco_amount Taco amount doesn't exist or is not a number
over_daily_taco_amount To many tacos given in a day
invalid_token Token doesn't exist or is incorrect
not_allowed GET not allowed
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us