Seek help (how to create a page in a database)

[dive2space]

Hi, thanks for your work. I am a python noob. I just don't know how to create a page in a database. Could you provide a code example? I will greatly appreciate it!

[lastorel]

Hi, Thank's for the question. Sorry, I converted it issue to the discussion

For the first you need Pytion method .page_create(page_obj, parent, properties, title). Let's see description

from pytion import Notion
no = Notion(token="YOUR TOKEN")
no.pages.page_create?
"""
Signature:
no.pages.page_create(
    page_obj: 'Optional[Page]' = None,
    parent: 'Optional[LinkTo]' = None,
    properties: 'Optional[Dict[str, PropertyValue]]' = None,
    title: 'Optional[Union[str, RichTextArray]]' = None,
    children: 'Optional[BlockArray, List[Block]]' = None,
) -> 'Optional[Element]'
Docstring:
:param page_obj:      you can provide `Page` object or -
                      provide the params for creating it:
:param parent:        LinkTo object with ID of parent element. workspace can not be a parent
:param properties:    Dict of properties with values
:param title:         New title
:param children:      Content of new page in [Block] or BlockArray format
:return:              self.obj -> Page
`parent = LinkTo.create(database_id="24512345125123421")`
`p2 = PropertyValue.create("date", datetime.now())`
`r = no.pages.page_create(parent=parent, properties={"Count": p1, "Date": p2}, title="Extra PAGE")`
`props["Status"] = PropertyValue.create("select", "new select option")`
`props["Tags"] = PropertyValue.create("multi_select", ["new-option1", "new option2"])`
`no.pages.create(parent=parent, properties=props)`
`parent2 = LinkTo.create(page_id="123412341234")`
`no.pages.page_create(parent=parent2, title="New page 121")`
File:      c:\users\slezy\pycharmprojects\pytion\pytion\api.py
Type:      method
"""

We need:

1. parent
2. properties
3. title

parent is the database where your new page will appear
properties is a set of Properties and Values of that database for the new Page (it can be empty)
and just title

1. Get your database ID:
   
   https://www.notion.so/lastorel/7e1abe9d000c4d6480160759ac8c0677?v=9d7c65a77b86436d42bd9292cce31d24&pvs=4
my_database = "7e1abe9d000c4d6480160759ac8c0677"
   Create and save LinkTo object:

from pytion.models import LinkTo

parent = LinkTo.create(database_id=my_database)

2. Next we need properties:
   According your database schema choose correct Property names and types (all available types you can see in README):

from pytion.models import PropertyValue

# choose only properties you want to set
props = {
            "Tags": PropertyValue.create(type_="multi_select", value=["tag1", "tag2"]),
            "done": PropertyValue.create("checkbox", True),
            "AnotherPropertyNAME": PropertyValue.create("date", datetime.now()),
        }

You can skip this (above) if you don't need properties.

3. execute method:

page = no.pages.page_create(parent=parent, title="Page 2")  # without properties
# or
page = no.pages.page_create(parent=parent, properties=props, title="Page 2")  # with properties

[dive2space]

Thank you very much!