Return HTTP status code 201 in flask


We’re using Flask for one of our API’s and I was just wondering if anyone knew how to return a HTTP response 201?

For errors such as 404 we can call:

from flask import abort

But for 201 I get

LookupError: no exception for 201

Do I need to create my own exception like this in the docs?

Asked By:



You can read about it here.

return render_template('page.html'), 201
Answered By: Iacks

As lacks suggested send status code in return statement
and if you are storing it in some variable like

notfound = 404
invalid = 403
ok = 200

and using

return xyz, notfound

than time make sure its type is int not str. as I faced this small issue
also here is list of status code followed globally

Hope it helps.

Answered By: Harsh Daftary

In your flask code, you should ideally specify the MIME type as often as possible, as well:

return html_page_str, 200, {'ContentType':'text/html'}

return json.dumps({'success':True}), 200, {'ContentType':'application/json'}


Answered By: Ben Wheeler

You can use Response to return any http status code.

> from flask import Response
> return Response("{'a':'b'}", status=201, mimetype='application/json')
Answered By: Yasir

You can do

result = {'a': 'b'}
return result, 201

if you want to return a JSON data in the response along with the error code
You can read about responses here and here for make_response API details

Answered By: Kishan K

In my case I had to combine the above in order to make it work

return Response(json.dumps({'Error': 'Error in payload'}), 
Answered By: Cheetara

you can also use flask_api for sending response

from flask_api import status

def empty_view(self):
    content = {'your content here'}
    return content, status.HTTP_201_CREATED

you can find reference here

Answered By: Akshita Karetiya

So, if you are using flask_restful Package for API’s
returning 201 would becomes like

def bla(*args, **kwargs):
    return data, 201

where data should be any hashable/ JsonSerialiable value, like dict, string.

Answered By: Deepak Sharma

Dependent on how the API is created, normally with a 201 (created) you would return the resource which was created. For example if it was creating a user account you would do something like:

return {"data": {"username": "test","id":"fdsf345"}}, 201

Note the postfixed number is the status code returned.

Alternatively, you may want to send a message to the client such as:

return {"msg": "Created Successfully"}, 201
Answered By: Croc

Ripping off Luc’s comment here, but to return a blank response, like a 201 the simplest option is to use the following return in your route.

return "", 201

So for example:

    @app.route('/database', methods=["PUT"])
    def database():
        return "", 201
Answered By: Matt Copperwaite

for error 404 you can

def post():
    #either pass or get error 
    post = Model.query.get_or_404()
    return jsonify(post.to_json())

for 201 success

def new_post():
    post = Model.from_json(request.json)
    return jsonify(post.to_json()), 201, 
      {'Location': url_for('api.get_post',, _external=True)}
Answered By: Josie Koay

You just need to add your status code after your returning data like this:

from flask import Flask

app = Flask(__name__)
def hello_world():  # put application's code here
    return 'Hello World!',201
if __name__ == '__main__':

It’s a basic flask project. After starting it and you will find that when we request you will get a status 201 from web broswer console.

Answered By: Xie Yuchen
Categories: questions Tags: , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.